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 有大量重复?
仅按提取结果中的代理入口 IP 去重,不能准确统计代理出口公网 IP。部分地区为保证网络速度、降低延迟,使用 IP 隧道代理,通过专线固定入口 IP 和随机端口,在一个时间点分配对应的代理出口公网 IP。
如果需要统计代理出口公网 IP 的重复情况,请联系客服开启相应的 JSON 提取信息,并在 API 提取链接后添加 &format=json。返回结果中的 remote_ip 表示代理出口公网 IP,仅用于去重统计,不能作为代理接入地址;连接代理仍使用 ip 和 port。
以下是返回结果中单条代理记录的字段示例:
1{2"ip": "113.120.29.24",3"port": 25369,4"remote_ip": "113.120.29.24"5}
我应该先看手册还是先看代码示例?
- 想确认参数、白名单、状态码和排障链路:先看 开发手册
- 想直接看不同语言怎么写:先看 代码示例&SDK下载