状态码

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 错误实现带有指数退避的重试逻辑。