错误与限制

身份验证和参数校验可能在执行前拒绝请求。请查阅错误参考，联系支持时保留 request_id。切勿发送密钥或密码。

响应 · HTTP

HTTP	说明
`400 / 422`	检查参数名称、类型、范围及必填值。
`401`	在 Authorization 请求头中使用当前有效密钥。
`403`	检查账户访问、有效权限、验证及 API 来源 IP 允许列表。
`404`	检查自己的记录 ID；不会公开其他账户记录。
`409`	重试前重新读取相关 revision/报价并确认原始操作状态。
`429`	等待 Retry-After 指定时间，再进行有限频率查询。
`5xx / timeout`	写操作结果不明确不等于失败。请查询同一操作，不要提交新购买或更改。

默认每个自然分钟最多 60 次请求，管理员可另行设置。请读取 capabilities.limits，并在 HTTP 429 时遵守 Retry-After。更新密钥不会清除账户用量。

HTTP 429

Retry-After: 15

{
  "ok": false,
  "error": { "code": "RATE_LIMITED" },
  "meta": { "request_id": "000000000000000000000429" }
}

每个预期写操作应保存一个 Idempotency-Key。超时或 HTTP 5xx 不代表失败。请用同一键查询状态，不要为了处理不确定结果而用新键重做操作。