共通エラー定義¶
以下のエラーは、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 で分岐処理できます。