错误与排查

识别鉴权、余额、参数、限流和搜索错误。

本页目录

错误格式

JSON

{"error":{"code":"SEARCH_UNAVAILABLE","request_id":"YOUR_REQUEST_ID"}}

请记录 HTTP 状态、错误码和请求编号。联系支持时提供请求编号，请勿发送 API Key 或密码。

状态	含义／处理
400 / 415	检查支持的参数和 Content-Type: application/json。
401	检查 X-API-KEY、多余空格及 Key 是否已撤销。
402	积分不足，请查看控制台余额。
429	触发限流。遵循 Retry-After，避免无限重试。
502 / 503	搜索失败或暂不可用，保留请求编号，持续出现时联系支持。
504	搜索超时。重新提交前请核对请求日志和余额；新的成功请求会计费。

先在控制台确认 Key 与余额，复现时明确指定 q、gl、hl。保留请求编号与时间。最终失败不扣费，可核对积分流水，避免反复创建新请求。

示例仅说明接口合同，不会执行搜索。联系支持时请勿提供 API Key。