この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

状況コードとエラー応答

エラーが発生した場合、または応答が正常な場合のどちらでも、応答ヘッダーには 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 を使用した場合。

1[
2{
3  "fields" : [ "Id" ],
4  "message" : "Account ID: id value of incorrect type: 001900K0001pPuOAAU",
5  "errorCode" : "MALFORMED_ID"
6}
7]

リソースが存在しない

存在しないリソースを要求した場合。たとえば、誤ったスペルのオブジェクト名を使用してレコードの作成を試みた場合など。

1[
2{
3  "message" : "The requested resource does not exist",
4  "errorCode" : "NOT_FOUND"
5}
6]

REST API 開発者ガイド

状況コードとエラー応答