API 代理开发 FAQ
这一页只回答 API 代理开发阶段最常见的问题。完整接入流程请看 API 代理开发手册,语言示例请看 API 代理代码资源。
提取链接返回 403,该先查什么?
优先检查当前发起请求的公网 IP 是否在订单白名单中。API 代理的白名单是按订单管理的,换机器、换网络或出口 IP 变化后都可能触发这个问题。
- 先看 API 代理开发手册 中的白名单说明
- 再看 错误码说明 中的
403 Forbidden
提取链接返回 429,该怎么处理?
这通常意味着你提取过快,而不是代理本身不可用。先降低提取频率,再确认是不是用 API 代理去做了“高频重复拉取、低频实际使用”的错误用法。
- 降低提取频率和并发
- 尽量在本地复用已提取的代理条目
- 如仍不够,再回到产品侧确认套餐与调用方式
line 和 json 应该选哪个?
- 想快速接入、只拿
ip:port:优先line - 需要看过期时间、真实出口或做本地过滤:优先
json
如果你要做代理池管理、过期过滤或调度策略,建议直接使用 json 格式。
提取到代理后,为什么访问目标站仍然失败?
API 代理只负责把代理列表交给你,后续的可用性验证、并发控制、请求头和 Cookie 管理都在你自己的程序里。
优先排查:
- 是否用了已过期代理
- 请求头是否过于“裸”
- 是否需要目标站白名单、登录态或 Referer
- 并发和请求速率是否过高
为什么有大量重复IP
- 直接统计API提取的代理IP进行去重是不准确的,因为部分地区为保证网络速度、降低网络延迟,提供的代理为IP隧道代理,该代理是通过专线固定IP+随机端口,在一个时间点> 上随机分配一个外网IP(又称:公网IP)。
- 如果要做外网IP去重,可以通过json提取代理信息(通知客服开启)。提取方式是在API提取链接后面加上“ &format=json”,这样能同时获取代理IP和当前对应的外网IP(remote_ ip字段) ,请用remote_ip做去重(该字段只能做去重统计,不能直接使用),格式如图:
1# 代理IP2"ip": "113.120.29.24"3# 代理端口4"port": 253695# 访问目标网站真实IP(仅用于统计,不能直接使用)6"remote_ip": "113.120.29.24"
我应该先看手册还是先看代码示例?
- 想确认参数、白名单、状态码和排障链路:先看 开发手册
- 想直接看不同语言怎么写:先看 代码示例&SDK下载