状态码与错误码对照表
提取接口的返回里 status=200 表示成功，其他取值都附带 msg 说明原因。下面把全部状态码列出来，并给出建议的处理方式——先看 status，再按建议动作，基本不用问客服就能解决。
状态码一览
| status | 含义 | 常见原因 | 处理建议 |
|---|---|---|---|
200 | 成功 | — | 正常使用；注意 QTY=0 时表示本次没有可用 IP |
401 | 请求参数不正确 | 缺 OrderNumber、参数拼写错误、订单号不存在 | 核对订单号与参数名；订单号请从会员中心复制 |
304 | 订单已到期 | 订单有效期已过 | 续费或重新购买，见 套餐页 |
204 | 套餐已过期 | 套餐周期结束 | 续费后即可继续提取 |
208 | 数量已用完 | 计量/去重计量套餐的可用量耗尽 | 充值或升级套餐；也可查看 leftIp 提前预警 |
205 | 套餐提取数量已达到上限 | 达到套餐的提取上限 | 联系客服确认是否可扩量，或改选不限量套餐 |
206 | 暂无可用 IP | 该城市/运营商当前资源紧张，或池子正在轮换 | 用 Area 换城市或去掉城市限制；用 ipinfo 看缓存数 |
406 | 提取频率过快 | 短时间大量调用接口（常见于循环单条提取） | 改成批量提取（qty=10~20）+ 本地小池子补货，间隔拉开 |
202 | 单次请求数量超出最大值 | qty 超过单次上限 | 降低 qty，多次提取 |
506 | 提取数量大于单次提取最大数 | 同上，线路侧限制更严格 | 降低单次数量后再试 |
203 | 白名单个数限制 | 白名单已满，本次请求的 IP 加不进去 | 删除不用的白名单（白名单接口），或升级套餐提高上限 |
207 | 提取机器超出服务范围 | 调用方不在该订单允许的范围内 | 检查是否用了代理去调接口；改用直连或把出口 IP 加入白名单 |
436 | 代理 IP 未经授权或已超出使用时长 | IP 超出授权时长或未授权 | 重新提取一条新的 IP |
504 | 代理 IP 状态异常 | 该条 IP 在上游异常 | 换一条 IP；连续出现请联系客服 |
505 | 代理 IP 节点异常 | 对应节点故障 | 换城市或稍后重试 |
关于错误响应的时间：当订单号不存在、订单已过期或参数拼写错误时，接口会故意延迟约 15 秒才返回错误，并可能临时限制该来源 IP，之后自动恢复。这是防刷设计，用来避免无效请求持续冲击接口，请勿用无效参数或过期订单反复轮询——客户端遇到这类返回应当停止重试并告警。
排查顺序（推荐）
- 先看 status：401/304/204 属于账号侧问题，先解决；20x 属于资源侧问题，换城市或换时间。
- 再看 QTY：status=200 但 QTY=0，说明接口通了但没有可用 IP，属于资源紧张。
- 然后是网络：拿到 IP 后连不上目标站，先直连目标站确认网络，再用
curl -x单独测这条代理。 - 最后看用量：返回里的
leftIp、leftTime能直接看出是不是量/时间不够了。
白名单接口的 code（另一套编号）
白名单接口返回的是 code/success/msg，不是 status，对照表见 白名单接口：0 成功、1 格式不合法、2 不存在、3 正在使用、4 添加过快。