标准
每 key 每分钟 600 次，突发 100。Webhook 推送不计入配额。
限流与错误码
宽松的默认配额、清晰的响应头、可预期的错误。
限流规则
响应头
每个响应都带 X-RateLimit-Limit / Remaining / Reset，方便你优雅退避。
更高配额
需要更高？企业版可提高上限，请联系销售。
错误码
400
invalid_param参数格式错误401
unauthorizedkey 缺失或无效403
forbiddenkey 无权限（与其所有者一致）404
not_found资源不存在409
conflict非法状态流转422
validation_failed业务校验失败（看 details[]）429
rate_limited请求过多，请退避500
internal_error服务端内部错误422 Unprocessable Entity
{
"error": "validation_failed",
"message": "qty must be positive",
"details": [{ "field": "lines[0].qty", "issue": "must be > 0" }]
}版本策略
所有端点都在 /v1 下。破坏性变更会发新大版本（/v2），并保证至少 12 个月并存期。新增字段/端点这类加法变更永远不会破坏现有集成。