亿牛云 Logo亿牛云

API 代理开发 FAQ

阅读模式

这一页只回答 API 代理开发阶段最常见的问题。完整接入流程请看 API 代理开发手册,语言示例请看 API 代理代码资源。

提取链接返回 403,该先查什么?

优先检查当前发起请求的公网 IP 是否在订单白名单中。API 代理的白名单是按订单管理的,换机器、换网络或出口 IP 变化后都可能触发这个问题。

提取链接返回 429,该怎么处理?

这通常意味着你提取过快,而不是代理本身不可用。先降低提取频率,再确认是不是用 API 代理去做了“高频重复拉取、低频实际使用”的错误用法。

  • 降低提取频率和并发
  • 尽量在本地复用已提取的代理条目
  • 如仍不够,再回到产品侧确认套餐与调用方式

line 和 json 应该选哪个?

  • 想快速接入、只拿 ip:port:优先 line
  • 需要看过期时间、真实出口或做本地过滤:优先 json

如果你要做代理池管理、过期过滤或调度策略,建议直接使用 json 格式。

提取到代理后,为什么访问目标站仍然失败?

API 代理只负责把代理列表交给你,后续的可用性验证、并发控制、请求头和 Cookie 管理都在你自己的程序里。

优先排查:

  1. 是否用了已过期代理
  2. 请求头是否过于“裸”
  3. 是否需要目标站白名单、登录态或 Referer
  4. 并发和请求速率是否过高

为什么提取到的代理 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
}

我应该先看手册还是先看代码示例?

相关入口