HTTP ステータス・コード

MC APIは、リクエストの成否を示すために、レスポンスに標準的な HTTP ステータスコードを使用する。 操作の説明に別段の記載がない限り、ステータスコードの値については以下の一般的な解釈が適用される。

表 1. HTTP ステータス・コード
HTTP ステータスコード HTTP ステータスメッセージ 説明
200 終了 リクエストは完全に成功した。 リクエストの結果を含むレスポンスボディが提供される。
204 コンテンツなし リクエストは完全に成功し、追加の応答情報は提供されない。
400 誤った要求 リクエストに必要な入力が欠けている、入力に誤りがある、または余計な入力が含まれている。 エラーに関する追加情報は、理由コードと追加情報を含むエラー応答ボディで提供される。
403 禁止 複数のエラー状態がこのステータスコードになる：
  • リクエストは認証を要求しているが、X-API-Sessionヘッダーが提供されていないか、提供されているがセッションIDが無効である。
  • APIリクエストが認証されたユーザーは、要求された操作を実行する権限がない。
404 未検出 複数のエラー状態がこのステータスコードになる：
  • URIは現存するリソースを指定しないか、APIユーザーがオブジェクトアクセス許可を持っていないリソースを指定する。
  • このURIは、MCが現在代替MCであるためにサポートされていないリソースまたは操作を指定する。
405 メソッドが許可されていません リクエストは、指定されたURIに対して有効でない HTTP メソッドを指定する。
409 競合 管理対象リソースは、要求された操作を実行するのに不適切な状態（ステータス）にある。 エラーに関する追加情報は、理由コードと追加情報を含むエラー応答ボディで提供される。
412 リソース変更 前提条件が失敗した。 クライアントが提供したETagとサーバーのETagが一致する場合、POSTを続行する。 そうでない場合は、412リソース変更エラーとなる。
413 要求本体が大きすぎます リクエストは大きすぎるリクエストボディを含む。
415 サポートされないメディア・タイプ リクエストのContent-Typeヘッダーは、 Web Services APIがサポートしない表現を指定する。
500 内部サーバー・エラー リクエスト処理中にサーバーエラーが発生しました。
45600 実装されていません リクエストは、(どのリソースに対しても)サーバーが認識できない HTTP メソッドを指定する。
503 サービス使用不可 一時的な事情により、三菱商事はこの要請を実行できなかった。
505 サポートされない HTTP バージョン リクエストは、 Web Services APIがサポートしていない HTTP プロトコルバージョンを指定する。