公開 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 寄給支援團隊。