コンテンツにスキップ

共通エラー定義

以下のエラーは、対応する 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 で分岐して処理できます。

フィードバック

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