状況コードとエラー応答
応答ヘッダーには、HTTP 状況コードが含まれます。応答が正常でない場合は、エラーメッセージがレスポンスボディに含まれ、必要に応じてエラーが発生した項目またはオブジェクトに関する情報も含まれます。
| HTTP 状況コード | 説明 |
|---|---|
| 200 | GET、PATCH、または HEAD 要求が成功しました。 |
| 201 | POST 要求が成功しました。 |
| 204 | DELETE 要求が成功しました。 |
| 400 | 要求が理解されませんでした。通常は、特定のリソースに対して無効な ID が使用されていることが原因です。たとえば、groupId が要求される場合に userId を使用すると、要求は 400 を返します。 |
| 401 | セッション ID または OAuth トークンが期限切れか無効です。また、要求がゲストユーザによって行われた場合、ゲストユーザはこのリソースにアクセスできません。レスポンスボディに message および errorCode が含まれます。 |
| 403 | 要求が却下されました。コンテキストユーザに要求されたデータへの適切なアクセス権限があること、またはコンテキストユーザが外部ユーザではないことを確認してください。 |
| 404 | 指定されたリソースが見つからなかったか、リソースが削除されています。 |
| 409 | 競合が発生しました。たとえば、要求がすでに承認または却下されているときに、グループへの参加要求を更新しようとすると競合が発生します。 |
| 410 | 要求されたリソースは、廃止または削除されました。このリソースへの参照は、削除するか更新してください。 |
| 412 | 前提処理が失敗しました。たとえば、バッチ要求で haltOnError が true に設定され、サブ要求が失敗した場合、後続のサブ要求は 412 を返します。 |
| 429 | 24 時間あたりの要求数を超えています。 |
| 500 | Salesforce 内でエラーが発生したため、要求を完了できませんでした。 |
| 503 | 1 時間あたりの要求数を超えているか、サーバがメンテナンスのため停止しています。 |
例
この要求ではコメント ID が必要ですが、代わりにフィード項目 ID が使用されています。
レスポンスボディは次のようになります。
1GET /chatter/comments/0D5D0000000XZoHKAW1HTTP/1.1 400 Bad Request
2Date: Fri, 22 May 2015 17:32:10 GMT
3Set-Cookie: BrowserId=D_3feNw7RYmP4DA;Path=/;Domain=.salesforce.com;Expires=Tue, 21-Jul-2015 17:32:10 GMT
4Expires: Thu, 01 Jan 1970 00:00:00 GMT
5Content-Type: application/json;charset=UTF-8
6Transfer-Encoding: chunked
7
8
9[ {
10 "errorCode" : "INVALID_ID_FIELD",
11 "message" : "Invalid identifier: 0D5D0000000XZoHKAW"
12} ]