すべての応答には HTTP ステータス コードが含まれ、ステータス コードが 204（コンテンツなし）以外の場合は、Accept ヘッダーが含まれています。応答のコンテンツは要求によって異なります。ドキュメントの本文が含まれる応答もあれば、URL のみが含まれる応答や空の応答もあります。

HTTP 応答コード

API クライアントは、応答内に HTTP ステータス コードのサブセットを想定できます。

表 1. API が返す HTTP ステータス コード
ステータス コード ステータスの説明
200 OK 要求が有効で、完了しました。応答にドキュメントの本文が含まれています。
201 Created 要求が有効です。要求されたオブジェクトが作成され、ロケーション ヘッダーに指定された URL で見つけることができます。
202 Accepted 要求が有効で、それを処理するためのタスクが作成されました。通常、この応答には TaskStatus 要素が伴います。
204 No Content 要求が有効で、完了しました。応答に本文は含まれません。
400 Bad Request 要求の本文の形式が正しくないか、不完全であるか、無効です。
401 Unauthorized ログインに失敗したか、認証トークンの有効期限が切れています。
403 Forbidden ユーザーが認証されていないか、要求で指定された 1 つ以上のオブジェクトにアクセスするための適切な権限がありません。
404 Not Found 要求で指定されたオブジェクトが見つかりませんでした。
405 Method Not Allowed 要求で指定された HTTP メソッドは、このオブジェクトではサポートされていません。
406 Not Acceptable 要求によって識別されたリソースは、要求の Accept ヘッダーで指定されたタイプの応答を生成することができません。
415 Unsupported Media Type 要求によって特定されたリソースは、指定された Content-Type および HTTP メソッドの要求をサポートしていません。
422 Not Found 通常、不正な要求 URL または要求本文を示します。
429 Too Many Requests クライアントが多数の要求を送信しているか、複数のクライアントが同時要求を多数送信していますが、サーバはレート制限のためにそれらを処理できません。

この問題を回避するには、後で再度要求を送信してください。

500 Internal Server Error 要求は受信されましたが、サーバで内部エラーが発生したため完了できませんでした。
503 Service Unavailable リソースの枯渇やサーバのメンテナンスなどの一時的な状態が原因で、サーバは現在要求を処理できません。
504 Gateway Timeout サーバがゲートウェイまたはプロキシとして機能しているときに、要求 URL で指定されたアップストリーム サーバからタイムリーな応答が返されませんでした。