🔌 API 文档

错误码完整说明

涵盖IP提取接口错误、隧道认证错误、代理节点运行时错误的完整查阅手册

提取接口错误码

调用提取接口时，响应体中的 code 字段标识结果（HTTP 状态码始终为 200）。

code	含义	常见原因	处理建议
0	提取成功	—	—
200	提取成功（隧道/不限量）	—	—
400	参数错误	未传 `package_id` 或 `key`；或用错了套餐类型的接口	检查请求参数是否完整，确认使用了正确的提取接口
400	套餐不存在或密钥错误	`package_id` 或 `key` 填写有误	登录控制台核对套餐 ID 和密钥
401	套餐不存在或密钥错误	同上（隧道/不限量接口）	同上
401	套餐已过期	套餐时间到期	续费套餐后重试
402	套餐 IP 已用尽	包量套餐的 IP 数量已全部使用完毕	购买新套餐或补量
402	今日提取配额已用尽	包时套餐每日提取上限已达到	等到次日 00:00 后重试
403	套餐已过期或状态不可用	套餐到期，或处于初始化失败等异常状态	续费套餐，或联系客服检查套餐状态
500	提取失败，请稍后重试	底层资源服务异常或网络问题	稍后重试，若持续出现请联系客服

错误响应格式：

{
  "code": 400,
  "message": "套餐不存在或密钥错误"
}

提取 IP 时若底层资源返回错误，平台会将错误信息透传到 message 字段（接口 code 为 500）。

使用隧道代理时，代理服务器在认证阶段以 HTTP 状态码形式返回错误。

错误码	含义	处理建议
400	请求参数错误	检查请求格式
401	认证字段异常（用户名/密码/session 为空、重复或格式错误）	重新调用提取接口获取最新认证信息
407	套餐信息异常 / 白名单信息异常	联系客服检查套餐配置
429	使用频繁，请稍后重试	降低请求频率后重试
452	套餐已禁用	联系客服
453	套餐已过期	续费套餐后重新提取认证信息
454	用户信息异常	联系客服
455	用户已禁用	联系客服
456	用户未实名认证	完成实名认证后重试
457	获取资源异常	稍后重试，若持续出现请联系客服
458	通道数已达上限	等待现有连接释放后重试，或联系客服升级套餐
459	并发数已达上限	同上
460	session 不存在	重新调用提取接口获取新的 session
500	服务异常	稍后重试，若持续出现请联系客服

使用海外隧道代理时，代理服务器在认证阶段返回的错误码。

使用代理 IP 发起请求时，代理节点可能在响应中携带如下错误码，说明连接失败的具体原因。

客户端 / 协议类

错误码	含义	处理建议
603	代理协议不支持	确认使用 HTTP 或 SOCKS5 协议
605	客户端请求超时	检查网络状态，适当延长超时时间
606	并发连接数过高	稍后重试或降低并发
615	客户端连接提前断开	常见于目标网站响应慢时客户端自身超时，可延长客户端超时设置
616	目标服务器提前关闭连接	更换 IP 重试
618	HTTP 请求超时	检查网络状态，延长超时时间
619	SOCKS5 请求超时	检查网络状态
620	SOCKS5 协议版本不对	确认使用 SOCKS5，而非 SOCKS4
622	SOCKS5 不支持 IPv6 目标	当前不支持 IPv6 目标地址

目标连接 / DNS 类

认证 / 流量类

节点系统类（联系客服处理）