リクエストの送信
Oracle Unified DirectoryのREST APIを使用してリクエストを送信する際は、次のガイドラインを使用してください。
URL構造
次のURL構造を使用して、Oracle Unified DirectoryのRESTリソースにアクセスします。
https://<subdomain>.<domain>.com:<port>/<resource-path>
説明:
-
<subdomain.domain>.com:<port>は、Oracle Unified Directoryが動作しているホストおよびポートです。 -
<resource-path>は、リソースを定義する相対パスです。
サポートされているメソッド
次の表にまとめているように、標準HTTPメソッド・リクエストを使用して、Oracle Unified Directoryに対して基本的なCRUD操作(作成、読取り、更新、削除)を実行できます。
| HTTPメソッド | 説明 |
GET |
1つ以上の完全または部分リソースに関する情報を取得します。 |
POST |
エンドポイントに応じて、新規リソースを作成するか、検索リクエストを作成します。 |
PATCH |
クライアントが指定した変更のセット(partial updates)でリソースを変更します。 |
DELETE |
リソースを削除します。 |
メディア・タイプ
次のメディア・タイプは、Oracle Unified DirectoryのREST APIによってサポートされています。
-
application/json
サポートされているヘッダー
Oracle Unified DirectoryのREST APIでは、HTTPリクエストまたはレスポンスのヘッダー・セクションで渡される可能性のある次のヘッダーをサポートしています。
| ヘッダー | 説明 | 例 |
コンテンツ・タイプ |
リクエストの本文のメディア・タイプ。POSTおよびPUTリクエストの場合、必須です。 | Content-Type: application/json |
ResponseTime |
リクエストの処理に要した時間(ミリ秒)。 | ResponseTime: 1000 |
Authorization |
HTTP認証の認証資格証明 |