錯誤碼與狀態碼

EasyAPI 錯誤碼與 HTTP 狀態碼對照：400、401、429、500 等常見錯誤的含義、OpenAI 風格錯誤回應範例，以及限流重試與問題排查建議。

API 錯誤以 HTTP 狀態碼表示類別，回應內容中可包含 error 物件（含 message、type、code 等欄位，與 OpenAI 風格相容）。

常見錯誤

HTTP 狀態碼	錯誤碼	描述
`400`	`invalid_request_error`	請求參數無效或缺少必填欄位
`401`	`invalid_api_key`	未提供或無效的 API Key
`429`	`rate_limit_exceeded`	請求頻率或配額超出上限
`500`	`server_error`	伺服器內部錯誤，請稍後重試

錯誤回應範例

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

處理建議

401：檢查 Authorization 標頭與 Key 是否有效
429：實作指數退避重試，或提升配額
500：記錄 request id（若有）並聯絡支援