ステータス・コード
RESTエンドポイントをコールすると、レスポンス・ヘッダーは、次の表に示す標準HTTPステータス・コードの1つを返します。 これらのステータス・コードは、レスポンス・ヘッダーの3桁の数字で、レスポンスの一般的な分類を示します。 たとえば、このコードは、リクエストが成功した(200秒)か、クライアント(400秒)またはサーバー(500秒)エラーが発生したかを示します。 400および500クラスのステータス・コードは、不良リクエストのトラブルシューティングに役立ちます。
| HTTPステータス・コード | 説明 |
|---|---|
200 OK |
完了しました! GETまたはPOSTメソッドが成功すると、200ステータス・コードが返されます。 たとえば、Create an engagementリクエストの場合、200ステータス・コードは、チャット・セッションが正常に作成されたことを示します。 |
400 Bad Request |
リクエスト・オブジェクトの検証に失敗しました。 入力フィールドの検証エラー、必須値の欠落など、欠落または無効な情報が含まれているため、リクエストを処理できなかったことを示します。 |
403 Forbidden |
Create an engagementリクエストの場合、ステータス403は、JSON Web Token (JWT)での検証が失敗したことを示します。 サポートされる他のエンドポイントでは、ステータス403は、コンシューマ・セッション識別子が不明であることを示します。 このリクエストを実行する権限がないことを示します。 このRESTリソースを使用するために必要なロールおよび権限がない可能性があります。 Retrieve queue statisticsエンドポイントではサポートされていません。
ノート: クラウド・リソースへのアクセスは米国のエクスポート法によって管理され、Oracle Global Trade Compliance (GTC)によって内部的に監視されます。 米国のエクスポート法に準拠していること、およびOracleが関連するクラウド・サービスへのアクセスを許可しているロケーションからRESTリソースにアクセスしていることを確認してください。 それ以外の場合は、レスポンスで403 HTTPステータス・コードを引き続き取得できます。 |
404 Not Found |
リソースが見つかりませんでした。 これは、クライアントがサーバーと通信できたが、サーバーがリクエストされたものを見つけられなかったことを示します。 |
408 Request Timeout |
このエラーは、継続を使用するリクエストで発生する可能性があります。 継続とは、Jetty webサーバー内でHTTPリクエストを一定期間一時停止する手段です。 継続がタイムアウトすると、408ステータス・コードが返されます。 これは、Create an engagementエンドポイントにのみ適用されます。 |
409 Conflict |
エンゲージメントはルーティング・ルールを介してキューから削除されました。 |
500 Internal Server Error |
リクエストの処理中にチャット・サーバーでエラーが発生しました。 |
501 Not Implemented |
サーバーがリクエストで使用されているメソッドをサポートしていないため、リクエストを処理できないことを示します。 |
503 Service Unavailable |
サーバーの過負荷が原因でサーバーがリクエストを完了できないことを示します。 この状態は通常一時的なものです。 |
504 Gateway Timeout |
サーバーはゲートウェイとして機能し、リクエストを完了するためのタイムリなレスポンスをアップストリーム・サーバーから受信しません。 |
ステータス・コードの詳細は、「インターネット・エンジニア・リング・タスク・フォース(IETF)」 webサイトを参照してください。