Skip to content
ANKK APPANKK Docs

錯誤處理

請同時查看 HTTP 狀態與回應內容。錯誤欄位依端點而異，完整契約請參閱 API 參考文件。

  • 發生逾時或暫時性 5xx 時，先使用已收到的內容或工作 ID 查詢狀態。重試相同操作時，保留相同內容與 idempotency_key，限制次數並逐步增加等待時間。HTTP 202 表示受理，不代表發布成功。
  • 遇到 409 idempotency_conflict，請比較原始請求及其結果。不要自動產生新金鑰。確認前次結果後，只有刻意建立新操作時才使用新金鑰。
  • 修正輸入、驗證或權限問題後再重試。遇到 429，請檢查錯誤與存在時的 Retry-After；方案額度耗盡可能需要等待重設或變更方案，而非短暫等待。
{
  "error": "insufficient_scope",
  "message": "publishing:write scope is required for this API request."
}