錯誤與上限
錯誤一律回 error.code 與 error.message。列出每一種 code 的意思、每小時上限,以及內文大小的限制。
請求出錯時,回應一律是這個形狀。code 給程式判斷,message 是給工程師看的英文說明。
{ "error": { "code": "not_found", "message": "Not found, or this API integration has no access to it." } }
所有的 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