Skip to main content
每個 /v1 錯誤回應皆為 application/problem+json（RFC 9457），並包含一組固定欄位：
請依據 code 進行分支處理，切勿依據 detail——code 是穩定的機器契約；detail 為供人閱讀的文字，可能會變更。當錯誤可歸因於特定的請求參數時，會包含 param。聯絡支援團隊時，請附上 request_id。

​
錯誤碼

此代碼集為封閉集合：新增代碼屬於公用契約的變更，並會透過 API 變更記錄公告。retryable: true 回應表示該狀況可能會自行解除，但並不證明寫入作業未產生任何影響。重試讀取作業時，請設定有限的嘗試次數與時間預算，並採用指數退避與抖動（jitter）。若有 Retry-After，請予以遵循，包括在可重試的 409 或 429 回應中亦然。 對於變更作業，請遵循該作業所記載的等冪性與復原契約。在支援的情況下，請保留原始金鑰與請求。發生逾時或 5xx 後，請勿自行產生新的金鑰：這樣做可能會重複執行已成功的寫入作業。對於不支援 Idempotency-Key 標頭的作業，該標頭無法提供任何保護。