响应码

每次请求不论成功与失败，响应头都会包含 X-Request-Id 的请求id, 将该数据反馈给我们，我们能更快帮助您排查定位问题。

响应 HTTP 状态码固定为 200；

响应体固定包含 code、message、data；

成功状态码 #

成功状态码统一为 code: 0 , 代表服务器已正常完成本次请求响应，解析结果响应码为200。

例如，一个正常的响应体如下:

{
    "code": 0,
    "message": "success",
    "data": {
        "http_status": 200,
        "outputs": {
            "html": "html content..."
        }
    }
}

解析结果响应错误码总览 #

阶段	可返回错误码
服务暂时异常	100001
请求参数校验	100301
API Key 鉴权	110102、110103、110104
套餐读取	110205
余额/额度校验	110301
爬虫执行链路	120001 – 120008

API Key 鉴权错误 #

错误码	触发场景
110102	API Key 缺失、格式错误、无效，或已被更新。
110103	API Key 当前已停用。
110104	API Key 状态异常，请重新获取后重试。

套餐错误 #

错误码	触发场景
110205	当前套餐状态异常，暂时无法用于本次请求。

余额错误 #

错误码	触发场景
110301	发起请求前账户可用额度或余额不足。

请求处理错误 #

错误码	触发场景
120401	请求在处理前未通过校验，例如请求频率过高、连接已中断，或请求内容不符合要求。
120402	当前服务繁忙，暂时无法接收该请求。
120403	请求处理失败，未能成功获取目标页面内容。
120404	请求处理时间过长，已超过可用时限。
120405	当前服务不可用，请稍后再试。
120406	当前请求中的某个参数值暂不支持。
120407	当前请求中的参数组合暂不支持。
120408	当前请求缺少必要条件，因此该能力无法使用。 示例：当请求 png 格式时，需要同时显式开启 JS 渲染能力。