狀態碼

Just Serp API 同時透過 HTTP 狀態碼與 JSON 回應中的業務 code 表示 API 請求結果。

狀態碼表

情境	HTTP 狀態	業務代碼	已扣點數
成功	200	200	✅ 是
無效參數	200	400	❌ 否
無效的 API 金鑰	401	401	❌ 否
點數不足	200	402	❌ 否
找不到資源	200	404	❌ 否
超出速率限制	200	429	❌ 否
內部伺服器錯誤	500	500	❌ 否

處理錯誤

當發生錯誤時，API 會回傳一個包含業務 code 和 message 的 JSON 物件，以協助您診斷問題。

錯誤回應範例

{
  "code": 401,
  "message": "X-API-Key is missing. Please set X-API-Key header."
}

我們建議對 500 錯誤使用指數退避實作重試邏輯。