REST API 開発者ガイド
j状況コードとエラー応答
エラーが発生した場合、または応答が正常な場合のどちらでも、応答ヘッダーには HTTP コードが含まれ、レスポンスボディには通常、次の情報が含まれます。
- HTTP 応答コード
- HTTP 応答コードに付随するメッセージ
- エラーが発生した項目またはオブジェクト (応答がエラーに関する情報を返す場合)
| HTTP 応答コード | 説明 |
|---|---|
| 200 | GET 要求、HEAD 要求、および一部の PATCH 要求の「OK」成功コードです。 |
| 201 | POST 要求および一部の PATCH 要求の「Created」成功コードです。 |
| 204 | DELETE 要求および一部の PATCH 要求の「No Content」成功コードです。 |
| 300 | 外部 ID が複数のレコードに存在する場合に返される値です。レスポンスボディには、一致するレコードのリストが含まれます。 |
| 304 | 要求のコンテンツが、指定された日時から変更されていません。日時は If-Modified-Since ヘッダーで指定されます。例については、「オブジェクトのメタデータの変更の取得」を参照してください。 |
| 400 | 要求が実行されませんでした。通常、JSON または XML のボディに含まれるエラーが原因です。 |
| 401 | 使用されたセッション ID または OAuth トークンが期限切れか無効です。レスポンスボディに message および errorCode が含ま���ます。 |
| 403 | 要求が却下されました。ログインユーザーに適切な権限があることを確認してください。エラーコードが REQUEST_LIMIT_EXCEEDED の場合、組織の API 要求の制限を超えています。 |
| 404 | 要求されたリソースが見つかりませんでした。URI にエラーがないか確認し、共有の問題がないことを確認してください。 |
| 405 | Request-Line に指定されたメソッドは、URI に指定されたリソースには許可されていません。 |
| 409 | リソースの現在の状態との競合が原因で要求を完了できませんでした。API バージョンが要求しているリソースに対応していることを確認してください。 |
| 410 | 要求されたリソースは、廃止または削除されました。このリソースへの参照はすべて、削除するか更新してください。 |
| 412 | 要求ヘッダーでクライアントが指定した 1 つ以上の前提条件を満たしていないため、要求は実行されませんでした。たとえば、要求に If-Unmodified-Since ヘッダーが含まれていて、指定した日付以降にデータが変更された場合などです。 |
| 414 | URI の長さが 16,384 バイトの制限を超えています。 |
| 415 | 要求内のエンティティは、指定されたメソッドではサポートされていない形式です。 |
| 420 | Salesforce Edge には、このリクエストホストで使用可能な転送情報がありません。Salesforce カスタマーサポートにお問い合わせください。 |
| 428 | 要求は、条件付きでないため実行されませんでした。If-Match などの条件付き要求ヘッダーの 1 つを要求に追加して、再送信してください。 |
| 431 | URI とヘッダーの組み合わせの長さが 16,384 バイトの制限を超えています。 |
| 500 | Lightning Platform 内でエラーが発生したため、要求を完了できませんでした。Salesforce カスタマーサポートにお問い合わせください。 |
| 502 | Salesforce Edge が Salesforce インスタンスと正常に通信できませんでした。 |
| 503 | サーバーは要求を処理できません。これは通常、サーバーがメンテナンスのために停止しているか、過負荷の状態になっている場合に発生します。 |
- 例: ID が不正
- JSON または XML (request_body.json または request_body.xml) を使用する要求に存在しない ID を使用した場合。
- リソースが存在しない
- 存在しないリソースを要求した場合。たとえば、誤ったスペルのオブジェクト名を使用してレコードの作成を試みた場合など。