跳到內容

錯誤與上限

錯誤一律回 error.code 與 error.message。列出每一種 code 的意思、每小時上限,以及內文大小的限制。

請求出錯時,回應一律是這個形狀。code 給程式判斷,message 是給工程師看的英文說明。

{ "error": { "code": "not_found", "message": "Not found, or this API integration has no access to it." } }
你們的系統開始一次工作流、收到結果示意圖
開始一次、查詢、送回決定,都可能回錯誤。用 code 判斷要不要重送。

所有的 code

HTTP code 意思 要重送嗎
400 bad_request 內文不是 JSON 物件、缺必填欄位、動作寫錯 改了再送
401 unauthorized 沒帶金鑰、金鑰錯了或已撤銷 不要
403 disabled 串接關掉了 不要
403 plan 團隊的方案沒有 API 不要
403 ip_not_allowed 來源 IP 不在白名單上 不要
404 not_found 找不到,或這個串接沒有權限 不要
409 conflict 現在的狀態不允許,例如工作流暫停了、同時跑的次數滿了、那一次已經結束 晚一點再送
409 already_resolved 那一則已經決定過或過期了 不要
413 too_large 知識同步的文字或檔案超過上限 改小再送
429 rate_limited 超過這個串接的每小時上限 照 retry-after 等一下再送
507 storage_full 團隊的知識庫空間滿了 清出空間再送

上限

  • 每小時上限:在串接上設定,預設 600 次。用同一個 Idempotency-Key 重送不算。
  • 內文:最多 64 KB。知識同步的文字最多 5 MB,檔案跟上傳到知識庫一樣。
  • Idempotency-Key:最多 200 個字。
  • 回呼:10 秒內要回應。

相關頁

本頁對應 v0.168.0