コンテンツにスキップ

共通エラー定義

以下のエラーは、External API の共通認証とリクエスト処理に適用されます。インターフェース固有のビジネスエラーについては、各インターフェースのページを参照してください。

HTTP ステータス errorCode 発生条件と対処
400 ft.InvalidNonce nonce の欠落または重複使用です。再試行ごとに新しい nonce を使用し、再署名してください。
400 ft.MissingAuthHeaderInfo Access Key、署名、またはタイムスタンプがありません。署名リクエストヘッダーを確認してください。
400 ft.IllegalTimestamp タイムスタンプが設定された許容偏差を超えています。クライアントの時計を同期し、Unix 秒を使用して再署名してください。
403 ft.CrosssValidateFailed 署名が一致しません。署名バージョン、元のリクエストパス、クエリ文字列、署名の原文を確認してください。
403 ft.Forbidden 署名アカウントの権限が不足しています。インターフェースに必要な読み取りおよび書き込み権限を確認してください。
404 ft.InvalidAccessKey Access Key が無効です。呼び出し先のサイトとプラットフォームアカウントの設定を確認してください。
404 ft.NotFoundAkSkCfg サービスで External API の署名アカウント設定が見つかりません。サービスの管理者に連絡してください。
406 ft.ParameterValidationFailed パラメータが宣言されたフィールド制限に違反しています。message 内のフィールドとルールに従ってリクエストを修正してください。
400 ft.RequestJsonFormatError JSON 構文エラーです。content.reason、line、column を使用して特定してください。
429 ft.ApiMultiEntryRateLimited インターフェースが設定済みのレート制限グループに該当しています。Retry-After(存在する場合)に従ってバックオフし、新しい nonce で再署名してください。
503 ft.ApiMultiEntryRateLimitUnavailable 該当するレート制限サービスが一時的に利用できません。後で再試行してください。
500 ft.InternalServerError 内部エラーです。調査のためにレスポンスの traceId を保存してください。

message は言語やフィールドのコンテキストによって変わる場合があります。クライアントは HTTP ステータスと errorCode で分岐処理できます。

フィードバック

このページは役に立ちましたか?