代理IP API 常见问题
这里收录接入过程中最常遇到的 10 个问题。每个问题都能在下面对应的文档里找到更详细的说明；如果返回了具体状态码，先对照 状态码表 看含义。
1. 提取返回 status=206（暂无可用 IP）怎么办？
先确认调用里有没有带 Area / Isp。指定城市后，该城市资源紧张时就会返回 206；去掉城市限制或换个城市通常立刻能取到。也可以用 action=ipinfo 看线路当前的「时时缓存ip数」，接近 0 说明池子确实紧张。
2. 提取到的代理 IP 连不上是什么原因？
按这个顺序排查：① 先直连目标站，确认本机网络和目标是通的；② 用 curl -x "http://ip:port" 单独测这条代理；③ 看这条 IP 是否已过期（split=json 返回里有 expire 字段）；④ 检查调用方出口 IP 是否在白名单里；⑤ 如果只有某个站点连不上，多半是该站封了这条 IP，换一条即可。
3. 白名单已满怎么办？
白名单条数由套餐决定。先用 action=getwhites 看列表，再用 action=deletewhite 删除不用的 IP；需要更多条数就升级套餐。提取时如果因为白名单满被拒，会返回 status=203，提示里通常还会带上该 IP 的等待时间。
4. 出现 status=406 提取频率过快怎么处理？
把"循环单条提取"改成"批量提取 + 本地小池子"：一次取 10~20 条，在本地排队使用，水位低了再补货；失败时退避 1~2 秒再试，不要零间隔重试。这样接口调用量能降一个量级。
5. 怎么指定城市或运营商？
在提取接口上加参数，例如 &Area=南京&Isp=电信，一次只能指定一个城市。覆盖范围以你账号线路为准，可选城市可以在 在线提取页 里直接选。
6. 用量是怎么计算的？
按套餐类型区分：计量 / 去重计量按提取条数计，流量套餐按消耗流量计，包时套餐在有效期内不限量（每天按购买时间点重置当日用量），不限量套餐按自然日重置。JSON 返回里的 leftIp、leftTime 能直接看出剩余量和剩余时间。
7. 订单号在哪里查看？
登录会员中心 → 「我的订单」，订单号是一串 32 位字符。它等同于凭证：任何人拿到都能调用你的接口，请只在服务端配置里使用，不要写进前端 JS、截图或公开仓库。
8. 接口必须用 HTTP 调用吗？能用 HTTPS 吗？
接口地址是 http://api.xydaili.net:2022/tools/ip.ashx，按 HTTP 调用即可（注意不要写 https、也不要带证书校验）。这只影响"取 IP"这一步；代理本身完全支持访问 HTTPS 目标站。
9. 同一条代理 IP 能开多少并发？
经验值：单条 IP 并发 2~5 条、每秒请求不超过 3 次比较稳；需要更高吞吐时，应该增加 IP 数量而不是把并发压在少数几条 IP 上。具体到你的目标站，可以用 qty=1 取一条 IP 做阶梯压测找拐点。
10. 可以先试用再购买吗？
可以。注册后在会员中心领取试用 IP，把 快速开始 的流程跑通、确认可用率和延迟后再选套餐。
11. 为什么订单号错误或订单过期时，接口要等十几秒才返回？
这是防刷设计：订单号不存在、订单已过期或参数错误时，接口会故意延迟约 15 秒返回错误，并临时限制来源 IP，之后自动恢复，避免无效请求持续冲击接口。客户端不要把这类错误当成可重试异常去循环调用，正确做法是记录并告警、同时检查订单状态。
还有问题？在 联系我们 页面可以直接加客服 QQ / 微信，带上订单号会更快定位。