error の値 (または HTTP ステータス) を参照してください。
この一覧では、ほとんどのエージェントやクライアントが遭遇するエラーを取り上げています。網羅的なものではありません。ここに記載されていないエラーを受け取った場合は、文書化のために issue を作成してください。
エラーレスポンスの形式
success: false と文字列の error を含む JSON を返します。利用可能なコンテキストが多い場合は、一部のエンドポイントで追加のフィールド (details、code) も含まれます。
エラー
429 レスポンスでは、利用可能な場合、Firecrawl は
Retry-After ヘッダー (秒単位) を含めます。リトライする前に、少なくともその時間だけ待ってください。
Agent
/agent およびそのステータス、トレース、スナップショット、キャンセルの各エンドポイントに固有のエラーです。トレースおよびスナップショットのエンドポイントは、上流のエラーボディを変更せずに中継するため、この 2 つでは上記の success フィールドを含まないボディが返される場合があります。HTTP ステータスと error 文字列で照合してください。
maxCredits 上限に達した実行は HTTP エラーを返しません。失敗したジョブとして完了します。ステータスエンドポイントを poll すると、クレジット上限に関するエラーメッセージを含む status: "failed"、data なし、creditsUsed: 0 が返されます。失敗した実行には課金されないためです。トレースでは、同じ結果が outcome: "credit_limit_reached" を持つ run.finished イベントとして表示されます。
トレースのエラーコード
error.occurred トレースイベントには、5種類の値のいずれかを持つ code を含む構造化された error オブジェクトが含まれます。また、各イベントには retryable boolean が含まれ、上記のリトライ可能列と同様に扱います。
リトライのガイダンス
Retry-After を優先します。
429 レスポンス
Retry-After ヘッダーがある場合は、すぐに再試行せず、必ずその指示に従ってください。
