API 代理开发 FAQ
这一页只回答 API 代理开发阶段最常见的问题。完整接入流程请看 API 代理开发手册,语言示例请看 API 代理代码资源。
提取链接返回 403,该先查什么?
优先检查当前发起请求的公网 IP 是否在订单白名单中。API 代理的白名单是按订单管理的,换机器、换网络或出口 IP 变化后都可能触发这个问题。
- 先看 API 代理开发手册 中的白名单说明
- 再看 错误码说明 中的
403 Forbidden
提取链接返回 429,该怎么处理?
这通常意味着你提取过快,而不是代理本身不可用。先降低提取频率,再确认是不是用 API 代理去做了“高频重复拉取、低频实际使用”的错误用法。
- 降低提取频率和并发
- 尽量在本地复用已提取的代理条目
- 如仍不够,再回到产品侧确认套餐与调用方式
line 和 json 应该选哪个?
- 想快速接入、只拿
ip:port:优先line - 需要看过期时间、真实出口或做本地过滤:优先
json
如果你要做代理池管理、过期过滤或调度策略,建议直接使用 json 格式。
提取到代理后,为什么访问目标站仍然失败?
API 代理只负责把代理列表交给你,后续的可用性验证、并发控制、请求头和 Cookie 管理都在你自己的程序里。
优先排查:
- 是否用了已过期代理
- 请求头是否过于“裸”
- 是否需要目标站白名单、登录态或 Referer
- 并发和请求速率是否过高
我应该先看手册还是先看代码示例?
- 想确认参数、白名单、状态码和排障链路:先看 开发手册
- 想直接看不同语言怎么写:先看 代码示例&SDK下载