其他接口:探活与 IP 池信息
这两个接口不消耗提取数量,适合放在监控脚本里:isiplive 判断接口是否可用,ipinfo 查看线路 IP 池的实时容量。
接口探活:isiplive
http://api.xydaili.net:2022/tools/ip.ashx?action=isiplive&OrderNumber=你的订单号
正常返回纯文本 ok。建议用你的监控系统每 1~5 分钟请求一次,返回不是 ok 或超时再告警;不要用它做高频探测,接口本身有频率限制。
# shell 监控示例:返回 ok 即正常
resp=$(curl -s "http://api.xydaili.net:2022/tools/ip.ashx?action=isiplive&OrderNumber=你的订单号")
[ "$resp" = "ok" ] && echo "API ok" || echo "API 异常: $resp"
IP 池信息:ipinfo
http://api.xydaili.net:2022/tools/ip.ashx?action=ipinfo&OrderNumber=你的订单号
返回按行组织的文本,每行对应一条线路池,字段之间用制表符分隔,形如:
线路名 时时缓存ip数 : 12800 每日去重数 : 356210
| 字段 | 说明 |
|---|---|
| 线路名 | 你账号可用的线路/池名称 |
| 时时缓存ip数 | 当前已缓存、可直接提取的 IP 数量。这个数接近 0 时,提取容易返回「暂无可用 IP」 |
| 每日去重数 | 当天已去重统计的 IP 数量,用来判断池子的新鲜度与规模 |
常见用法
- 容量预警:把「时时缓存ip数」接入监控,低于阈值时提前联系客服扩容或切换城市。
- 排查提取为空:出现
status=206(暂无可用 IP)时,先看 ipinfo 的缓存数,再判断是不是指定了资源较少的城市。 - 接口健康检查:isiplive + 一次真实的
qty=1提取,是最贴近业务的健康检查组合。
注意事项
- 两个接口都需要有效的
OrderNumber,订单过期会返回status=304。 - 返回都是纯文本,不要按 JSON 解析;ipinfo 用制表符拆分。
- 不要把它放进高并发循环里,探活 1 分钟一次足够了。