リクエストの送信

Oracle Unified Directory Data Management REST APIを使用してリクエストを送信する場合、次のガイドラインを使用します。

URLの構造

リクエストのURL構造は次のとおりです:

https://<subdomain>.<domain>.com:<port>/<resource-path>
変数の意味は次のとおりです:
  • <subdomain.domain>.com:<port>: Oracle Unified Directoryが動作しているホストおよびポート。

  • <resource-path>: リソースを定義する相対パス。

サポートされているメソッド

次の表にまとめているように、標準HTTPメソッド・リクエストを使用して、リソースに対して基本的なCRUD操作(作成、読取り、更新、削除)を実行できます。

HTTPメソッド 説明
GET 1つ以上の完全または部分リソースに関する情報を取得します。
POST エンドポイントに応じて、新規リソースを作成するか、検索リクエストを作成します。
PATCH クライアントが指定した変更のセット(partial updates)でリソースを変更します。
DELETE リソースを削除します。

メディア・タイプ

Oracle Unified Directory Data Management REST APIでは、次のメディア・タイプがサポートされています:

  • application/json

サポートされているヘッダー

Oracle Unified Directory Data Management REST APIでは、HTTPリクエストまたはレスポンスのヘッダー・セクションで渡される可能性のある次のヘッダーをサポートしています。

ヘッダー 説明
Authorization HTTP認証の認証資格証明  
Content-Type リクエストの本文のメディア・タイプ。POSTおよびPUTリクエストの場合、必須です。 Content-Type: application/json
ResponseTime リクエストの処理に要した時間(ミリ秒)。 ResponseTime: 1000