Status Codes
Just Serp API 使用 HTTP 狀態碼和 JSON 響應中的業務邏輯 code 來指示 API 請求的結果。
狀態碼表
| Scenario | HTTP Status | Business Code | Credits Charged |
|---|---|---|---|
| Success | 200 | 200 | ✅ Yes |
| Invalid Parameters | 200 | 400 | ❌ No |
| Invalid API Key | 401 | 401 | ❌ No |
| Insufficient Credits | 200 | 402 | ❌ No |
| Resource Not Found | 200 | 404 | ❌ No |
| Rate Limit Exceeded | 200 | 429 | ❌ No |
| Internal Server Error | 500 | 500 | ❌ No |
處理錯誤
當發生錯誤時,API 會返回一個包含業務 code 和 message 的 JSON 對象,幫助您診斷問題。
錯誤響應示例
json
{
"code": 401,
"message": "X-API-Key is missing. Please set X-API-Key header."
}我們建議對 500 錯誤使用指數退避實現重試邏輯。
