エラーレスポンス

EP-APIのエラー

EP-APIのリクエストでエラーが発生した場合、APIは以下の方法でクライアントプログラムにエラーを通知します。

  1. HTTP Status Code
  2. レスポンスボディ (JSON)

エンドポイントURLが誤っているなど、EP-APIのリクエストパラメータ以外にエラーの原因がある場合、APIはレスポンスパラメータを返さず、HTTP Status Codeのみを返します。

APIを呼び出すクライアントプログラムは、まずHTTP Status Codeを確認し、エラーであることが確認できた場合にレスポンスパラメータの中のErrorTypeやErrorMessage、ErrorDetailを確認するようにしてください。

エラー発生時のレスポンス形式
{
    "ErrorResponse": {
        "RequestId": "xxxxxxxxxxxxxxxxxx",
        "ErrorType": "errortype",
        "ErrorMessage": "errormessage",
        "ErrorDetail": {...}
    }
}

レスポンスパラメータ

パラメータタイプ意味
ErrorResponse.RequestIdString

APIリクエスト毎に割り当てられるユニークなID

ErrorResponse.ErrorTypeStringエラーの原因 (以下の表参照)
ErrorResponse.ErrorMessageStringエラー発生原因についての説明
ErrorResponse.ErrorDetailObjectエラー発生原因の詳細
エラーが発生した場合の対応

APIリクエスト時にエラーが発生した場合、APIを呼び出したプログラムが適切に処理を行う必要があります。

システムエラーが発生し、時間が経ってもエラーが回復しない場合は弊社サポートセンターにお問い合わせください。

 共通エラー

エラーHTTP Status CodeErrorTypeErrorMessageErrorDetail意味備考
HTTP/1.1以外505(なし)

HTTP1.1以外のリクエストを受け付けたレスポンスパラメータは返却されません
URL不正404(なし)

以下のいずれかの場合

  • アクセスURLが正しくない
  • 存在しないAPIが指定された
  • APIVersionパラメータが不正
  • 指定された以外のHTTP メソッドを利用した
レスポンスパラメータは返却されません
メソッド不正405(なし)

指定されたHTTPメソッド以外を利用した


認証エラー

(署名検証エラー)







400



BadRequest


Signature is not valid.
Signatureパラメータが存在しない
Signature method is not valid.
SignatureMethodパラメータが不正
Signature version is not valid.
SignatureVersionパラメータが不正
Expire is not valid.
Expireパラメータが不正
RequestExpiredThe request has expired.
Expireで指定された期間を過ぎている
401AuthFailureUnable to validate the provided access credentials.
指定したAccessKeyが無効
403SignatureDoesNotMatchThe request signature we calculated does not match the signature you provided.
Signatureの値がリクエストの内容と合致しない
パラメータエラー

400ParameterErrorThere are invalid parameters.
不正なパラメータが含まれている
Duplicated parameter found.
パラメータが重複している
200(個別)(個別)(個別)API固有のエラーAPI固有のエラーの場合、Status Codeは200となります
システム障害500SystemErrorSystem error occurred.

API設備のシステム障害

サポートセンターへお問い合わせください
タイムアウト503TimeoutSystem is busy.
リクエストのタイムアウト
HTTPでアクセス403Required to use https.

HTTPでアクセスした

必ずHTTPSを使用してください

メンテナンス中403StatusErrorService is stopping by maintenance.
メンテナンス中のためEP-APIを利用できない