共通エラー定義¶
以下のエラーは、対応する OpenAPI の認証、レート制限、またはリクエスト処理のシナリオに適用されます。インターフェース固有のビジネスエラーは各インターフェースページを参照してください。
| HTTP ステータス | errorCode | 発生条件と対処 |
|---|---|---|
| 401 | ft.APIAkKeyFailed | リクエストに API Key がありません。DF-API-KEY リクエストヘッダーを確認してください。 |
| 401 | ft.InvalidAPIKey | API Key が無効です。使用している Key とアクセス先のサイトを確認してください。 |
| 403 | ft.APIKeyDisabled | API Key が無効化されています。管理者に連絡するか、使用可能な Key を使用してください。 |
| 403 | ft.Forbidden | 現在の Key の権限が不足しています。インターフェースに必要な権限を確認してください。 |
| 423 | ft.NotInIpWhileList | アクセス元がワークスペースの OpenAPI IP ホワイトリストに一致していません。管理者に連絡して送信元アドレスを確認してください。 |
| 401 | ft.TriggerApiAkCurrentLimiting | 現在の API Key が旧バージョンの AK レベルのレート制限を超えています。頻度を下げて再試行してください。 |
| 401 | ft.TriggerApiWorkspaceCurrentLimiting | ワークスペースが旧バージョンのワークスペースレベルのレート制限を超えています。該当ワークスペースの合計呼び出し頻度を下げてください。 |
| 429 | ft.ApiMultiEntryRateLimited | インターフェースが設定済みのレート制限グループに該当しました。Retry-After(存在する場合)に従ってバックオフしてください。 |
| 503 | ft.ApiMultiEntryRateLimitUnavailable | 適用されるレート制限サービスが一時的に利用できません。しばらくしてから再試行してください。 |
| 400 | ft.RequestJsonFormatError | JSON 構文エラーです。content.reason、line、column で特定してください。旧インターフェースに互換性のためのエラーコードがある場合は、インターフェースページを確認してください。 |
| 406 | ft.ParameterValidationFailed | パラメーターが宣言されたフィールド制約に違反しています。message 内のフィールドとルールに従ってリクエストを修正してください。 |
| 500 | ft.InternalServerError | 内部エラーです。レスポンスの traceId を保存して調査に役立ててください。 |
message は言語やフィールドのコンテキストによって変わる場合があります。クライアントは HTTP ステータスと errorCode で分岐して処理できます。