接口线路类型一[集群IP接口-免费]

[接口地址1]
:当前负载【
优】 接口通讯【
正常】
复制
测速

[接口地址2]
:当前负载【
优】 接口通讯【
正常】
复制
测速

[接口地址3]
:当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]

[接口地址]
:[自动分发到集群接口均衡负载,但可能因网络运营商DNS缓存如果某个集群接口发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]

[彩钻接口]
:[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。]
复制
测速
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
名称 |
参数 |
必填 |
说明 |
用户ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
用户KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
指定IP | ip | 否 | 欲查询的IP,支持IPV4和IPV6,如果不填则默认为请求接口IP。例:ip=49.234.56.78 |
查询通道 | td | 否 | 只支持IPV4选择通道,0-2,0=接口盒子官方加多通道查询,1=1号通道,2=2号通道,在查询信息有误的情况下可以选择其他通道修正,但并不是某个通道就会一直准确,每个查询通道都会在一定程度上出现信息误差。一般默认0采用综合通道查询。例:td=1 |
用户IPV4 | uip | 否 | 接口调用者IPV4,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用中间件请求接口的方式使用。例:uip=123.123.123.123 |
返回参数说明
名称 |
参数 |
说明 |
状态码 | code | 200成功,400错误 |
消息内容 | msg | 如果状态码返回400则返回错误信息提示,200则返回位置描述。 |
大洲 | zhou | 大洲。 |
国家 | guo | 国家。 |
省 | sheng | 省级名称。 |
市 | shi | 市级名称。 |
区 | qu | 区级名称。 |
运营商 | isp | 运营商名称。 |
纬度 | lat | 纬度。 |
经度 | lon | 经度。 |
国家代码 | guocode | 国家代码。 |
IP | ip | 被查询的IP。 |
内部参数 | td | 内部参数。 |
返回数据示例
示例:{"code":400,"msg":"查询失败,请重试。"}
示例:
{
"code": 200,
"zhou": "亚洲",
"zhoucode": "AS",
"guo": "中国",
"guocode": "CN",
"sheng": "四川省",
"shengcode": "510000",
"shi": "绵阳市",
"shicode": "510700",
"qu": "江油市",
"qucode": "510781",
"isp": "中国联通",
"lat": "31.780729760241",
"lon": "104.742802217388",
"msg": "亚洲-中国-四川省-绵阳市-江油市-中国联通",
"ip": "112.192.49.243",
"td": "1-1"
}
更新记录
2025-04-24 14:42:18 - 全量更新接口盒子官方全球IP库,大大优化了查询逻辑,实现1毫秒级IP库查询速度,同时新增行政区划代码等返回参数。2025-04-08 23:50:16 - 新增支持IPV6查询。2025-04-07 19:48:30 - 新增请求参数【td】,可以选择查询通道。新增返回参数【guocode】,返回国家简称。2025-04-05 22:21:54 - 优化接口查询通道,结合接口盒子官方库及大数据多通道查询,确保稳定性。新增返回参数【lat】纬度,【lon】经度。2024-09-21 02:30:10 - 优化查询流程,修复某IP查询失败BUG。2024-09-19 14:33:36 - 优化查询逻辑,提升查询速度。2024-08-04 22:09:23 - 增加一个返回IP参数,返回被查询的IP。2024-03-25 12:35:32 - 新增接口。