请求方式:
HTTP
HTTPS
POST
GET
返回格式:
JSON
XML
JSONP
请求接口:
计费说明:
正常请求免费不限制,使用密钥首次查询消耗1积分,1小时内同IP重复查询不计费。
如果查询量较大或需要稳定使用,请使用应用密钥appKey请求接口。
- 请求参数
- 返回参数
参数名 | 类型 | 必传 | 说明 |
---|---|---|---|
ip | string | 否 | 要查询的IP,不传默认取当前请求者IP |
appKey | string | 否 | 接口查询应用密钥,查询量较大或者超过频率限制需要传,登录后获取。 |
format | string | 否 | GET请求,返回格式,默认json,其他可选:xml、ip、jsonp 传ip时其他参数失效,只返回请求者IP,常用于软件开发获取用户外网IP。 |
callback | string | 否 | GET请求,返回节点,默认callback,当format=xml或jsonp时有效。 |
字段名 | 类型 | 必返 | 说明 | ||
---|---|---|---|---|---|
code | int | 是 | code=1查询成功,code=0查询失败,msg返回失败原因 | ||
ip | string | 是 | 查询的IP | ||
address_net | string | 否 | 解析地址A,优于address地址 | ||
address | string | 是 | 解析地址B,建议address_net没结果才取这个地址 | ||
prov | string | 否 | 省份 | ||
city | string | 否 | *城市 | ||
district | string | 否 | *区域 | ||
town | string | 否 | *镇街道 | ||
*注意:移动数据流量IP范围复杂,会出现跨城市、区、镇街道,接口只返回对应IP最近出现次数最多的区域,可能会和期望的有误差。 |
- 成功示例
- 失败示例
{
"code": 1,
"ip": "8.8.8.8",
"detail": "电信",
"address_net": "广东省深圳市龙岗区南湾街道 电信",
"continent": "亚洲",
"country": "中国",
"isp": "电信",
"prov": "广东省",
"city": "深圳市",
"district": "龙岗区",
"town": "南湾街道",
"owner": "电信",
"address": "广东省深圳市",
"msg": ""
}
{
"code": 0,
"ip": "8.8.8.8",
"detail": "",
"address_net": "超过频率限制",
"continent": "",
"country": "",
"isp": "",
"prov": "",
"city": "",
"district": "",
"town": "",
"owner": "",
"address": "超过频率限制",
"msg": "超过频率限制"
}