參考

錯誤和速率限制

REST 錯誤使用此信封。保留請求 ID 以取得支持，並且切勿記錄您的 API 金鑰：

從程式碼和 requestId 開始

穩定的程式碼告訴你的程式發生了什麼事。人類可讀的訊息解釋了此請求。聯絡支援人員時保存 requestId。

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

對於 401，請檢查標頭是否以 Bearer 開頭，後面跟著一個空格和一個活動鍵。對於 403，請檢查建立金鑰時所選擇的帳戶計畫和範圍。

對於409或422，確認PUT完成，Content-Type匹配，並且上傳的位元組數等於sizeBytes。如果臨時 URL 過期，則建立新的上傳作業。

程式碼	HTTP	意義
BAD_REQUEST	400 / 409	HTTP 400 表示請求體無效； HTTP 409 表示在目前狀態下無法完成上傳。
UNAUTHORIZED	401	API 金鑰遺失、無效或已撤銷。
PAID_PLAN_REQUIRED	403	該帳戶沒有符合資格的付費方案。
INSUFFICIENT_SCOPE	403	API 鍵不包含所需的範圍。
NOT_FOUND	404	找不到擁有的上傳、檔案或分享。
UPLOAD_NOT_READY	409	上傳的物件尚未準備好完成。
FILE_TOO_LARGE	413	文件超出了適用的大小限制。
OBJECT_VALIDATION_FAILED	422	上傳的對象驗證失敗。
QUOTA_EXCEEDED	429	上傳配額已用完。
RATE_LIMIT_EXCEEDED	429	API 請求率已耗盡。
SERVICE_UNAVAILABLE	503	所需的服務暫時無法使用。

僅在 Retry-After 之後重試 429。使用指數退避重試暫時 503 錯誤。不要自動重試無效的 400、401 或 403 請求。