错误

每个错误响应都有相同结构：


{
  "error": {
    "code": "invalid_request",
    "message": "title is required"
  }
}

错误代码

代码	状态	定义
`unauthorized`	401	缺失、格式错误、已撤销或未知的 API密钥。
`forbidden`	403	有效密钥，但计划不允许此操作（写入需要付费计划）。
`invalid_request`	400	验证失败 — 错误的 JSON、缺失字段或无效的查询参数。
`not_found`	404	未知路由或项目中不存在该 id 的资源。
`limit_reached`	429	已耗尽每月提交配额。
`rate_limited`	429	当前窗口请求太多 — 等待并重试。
`internal_error`	500	我们这边发生了某种错误。可以重试。

此列表是完整的 — API不返回其他代码。

Last updated on 2026年8月14日

Webhooks 限流与用量