リクエストの送信
Oracle Identity Governance (OIG) Self Service REST APIを使用してリクエストを送信する際は、次のガイドラインを使用してください。
URLの構造
OIG Self Service RESTリソースには、次のURL構造を使用してアクセスします。
https://<subdomain>.<domain>.com:<port>/<resource-path>
各要素の意味は次のとおりです。
-
<subdomain.domain>.com:<port>: OIGを実行しているホストおよびポート。 -
<resource-path>: リソースを定義する相対パス。
サポートされているメソッド
次の表にまとめているように、標準HTTPメソッド・リクエストを使用して、OIG Self Serviceに対して基本的なCRUD操作(作成、読取り、更新、削除)を実行できます。
| HTTPメソッド | 説明 |
GET |
1つ以上の完全または部分リソースを取得します。 |
HEAD |
デフォルトのjerseyサポート。 |
POST |
エンドポイントに応じて、新規リソースを作成するか、検索リクエストを作成します。 |
PUT |
既存の属性を指定した置換属性のセット(replace)で置換することでリソースを変更します。PUTを使用して新規リソースを作成する必要があります。 |
PATCH |
クライアントが指定した変更のセット(partial updates)でリソースを変更します。 |
OPTIONS |
デフォルトのjerseyサポート。 |
DELETE |
リソースを削除します。 |
メディア・タイプ
OIG Self Service REST APIでは、次のメディア・タイプがサポートされています。
-
application/json -
application/xml
サポートされているヘッダー
OIG Self Service REST APIでは、HTTPリクエストまたはレスポンスのヘッダー・セクションで渡される可能性のある次のヘッダーをサポートしています。
| Header | 説明 | Example |
Content-Type |
リクエストの本文のメディア・タイプ。POSTおよびPUTリクエストの場合、必須です。 | Content-Type: application/json |
ResponseTime |
リクエストの処理に要した時間(ミリ秒)。 | ResponseTime: 1000 |
X-Requested-By |
GET以外のリクエストを送信するすべてのクライアントはカスタムHTTPヘッダー(X-Requested-By)を含めます。これが含まれないリクエストはすべて無視され、400エラーが返されるためです。 | CSRF-header |