错误结构
接口出错时返回统一结构：
{ "detail": "错误信息" }
常见状态码
| 状态码 | 含义 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 未认证或凭证无效 |
| 403 | 权限不足 / CSRF 校验失败 |
| 404 | 资源不存在 |
| 409 | 冲突（如重复发布） |
| 429 | 请求过于频繁 |
| 500 | 服务端错误 |
限流
限流有两层：
- Cloudflare Worker 边缘按 IP / API Key 限流。
- 塔台按 API Key 哈希再限一次。
默认是每分钟 20 次，服务端可以调。命中限流返回 429，响应头里有 Retry-After，按那个时间等就行，别硬重试。