状況コードとエラー応答
エラーが発生した場合、または応答が正常な場合のどちらでも、応答ヘッダーには HTTP コードが含まれ、レスポンスボディには通常、次の情報が含まれます。
- HTTP 応答コード
- HTTP 応答コードに付随するメッセージ
- エラーが発生した項目またはオブジェクト (応答がエラーに関する情報を返す場合)
| HTTP 応答コード | 説明 |
|---|---|
| 200 | GET または HEAD 要求の「OK」成功コードです。 |
| 201 | POST 要求の「Created」成功コードです。 |
| 204 | DELETE 要求の「No Content」成功コードです。 |
| 300 | 外部 ID が複数のレコードに存在する場合に返される値です。レスポンスボディには、一致するレコードのリストが含まれます。 |
| 304 | 要求のコンテンツが、指定された日時から変更されていません。日時は If-Modified-Since ヘッダーで指定されます。例については、「オブジェクトのメタデータの変更の取得」を参照してください。 |
| 400 | 要求が実行されませんでした。通常、JSON または XML のボディに含まれるエラーが原因です。 |
| 401 | 使用されたセッション ID または OAuth トークンが期限切れか無効です。レスポンスボディに message および errorCode が含まれます。 |
| 403 | 要求が却下されました。ログインユーザに適切な権限があることを確認してください。 |
| 404 | 要求されたリソースが見つかりませんでした。URI にエラーがないか確認し、共有の問題がないことを確認してください。 |
| 405 | Request-Line に指定されたメソッドは、URI に指定されたリソースには許可されていません。 |
| 415 | 要求内のエンティティは、指定されたメソッドではサポートされていない形式です。 |
| 500 | Force.com 内でエラーが発生したため、要求を完了できませんでした。Salesforce カスタマーサポートにお問い合わせください。 |
- 例: ID が不正
- JSON または XML (request_body.json または request_body.xml) を使用する要求に存在しない ID を使用した場合。
- 例: リソースが存在しない
- 存在しないリソースを要求した場合。たとえば、誤ったスペルのオブジェクト名を使用してレコードの作成を試みた場合など。