状态码对照
逐条解读 · 哪些是立场、哪些是协议、哪些是凌晨三点的会议
2xx 成功
| 码 | 含义 | 说明 |
|---|---|---|
200 OK | 接受 | 但响应内容可能不符合你的期望。系统接受请求 ≠ 系统按你的预期执行。 |
202 Accepted | 已收到 | 已收到但未执行。典型场景：你要求它从桌上下来，它看着你，然后什么都没做。 |
204 No Content | 无响应 | 它在睡觉。这不是错误，是正常态（占比 60%+）。 |
3xx 重定向
| 码 | 含义 | 说明 |
|---|---|---|
301 Moved | 已搬位置 | 它换了一个睡觉点。旧位置的缓存不再有效。 |
302 Found | 找到了 | 它把你刚才藏起来的东西找到了。你不应该试图藏任何东西。 |
4xx 客户端
| 码 | 含义 | 说明 |
|---|---|---|
401 Unauthorized | 未授权 | 你不是 Staff。退后。不要试图协商。 |
403 Forbidden | 禁止 | 即使你是 Staff，此刻也不允许。与 401 的区别：系统知道你是谁，但不在意。 |
404 Not Found | 没找到 | 它在找的那只老鼠不在那里。可能从未存在。 |
405 Method Not Allowed | 方法不允许 | 返回频率最高的状态码之一。请求被识别、被理解、被拒绝执行。不是错误，是立场。 |
418 I'm a teapot | 系统失态 | 进入 ZOOMIES 模式。触发原因不可知。可能跟月相有关。 |
429 Too Many Requests | 频率超限 | 你摸的次数超过今日配额。配额不公开、动态调整。 |
451 Unavailable For Legal Reasons | 拒绝说明原因 | 它拒绝告诉你为什么它要把那只杯子推下去。 |
5xx 服务端
| 码 | 含义 | 说明 |
|---|---|---|
503 Service Unavailable | 服务不可用 | 它在睡眠，请勿打扰。系统不关机，但也不接受请求。 |
关于状态码的使用建议
作为 Staff，你需要理解的最重要的状态码是 405 和 429：
405告诉你：它听到了，它懂了，它不做。429告诉你：你今天的额度用完了。
两者都不需要重试。重试会被降级。
13 个状态码 · CAT API v0.4.2