首页 > API 文档 > 其他接口

其他接口:探活与 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 分钟一次足够了。

相关文档