HTTP 行为

本节汇总通用于多个接口的 HTTP 行为规则。

通用规则

• REST API 使用真实 HTTP 状态码，不对所有结果都返回 200
• 响应体使用统一响应包络
• 客户端必须同时基于 HTTP 状态码和响应体 code 分支
• 错误响应省略 data
• 429 RATE_LIMITED 响应包含 Retry-After
• 有副作用的命令重试必须复用同一个 Idempotency-Key，详见 限流与重试

建议按下面顺序阅读：

1. 服务地址与请求头
2. 权限范围
3. 分页规则
4. 限流与重试
5. 状态码总览