公开 API

分辨 401、403、422 与 429

401 的意思是这把密钥根本没被接受。403 是密钥被接受了，但这个操作不被允许。422 是请求已被理解，而载荷有误。429 是你越过了限流，应当等待而不是立刻重试。

最后校订 2026年8月20日

步骤

1. 遇到 401，检查密钥是否存在、是否过期、是否发在你以为的那个头里——常见成因是粘贴时被截断。
2. 遇到 403，读一读 code：权限范围不足、地址不在允许名单里，或密钥属于另一个工作区。重连没有用，该变的是权限。
3. 遇到 422，读响应点名的那个字段，然后把载荷改对。
4. 遇到 429，尊重限流响应头并等待。立刻再发只会更糟。
5. 留好响应里的 requestId——支持团队正是靠它找到你那一次具体调用。

如何验证结果

改正之后同一个请求成功了，响应带着 2xx 状态和预期的对象。

常见的出错之处

• 把 403 当成密钥坏了，于是重新签发，而这什么也改变不了。
• 在密集的循环里反复撞 429。
• 把密钥而不是请求 ID 发给支持团队。