接口描述:
根据查询的IP地址,查询该IP所属的区域,如:国家/地区、城市、运营商等。支持全球,暂不支持IPv6。
请求URL:
https://api.jiadeapi.com/ip/query
请求方式:
http get/post
请求Header:
|
名称 |
值 |
|
Content-Type |
application/x-www-form-urlencoded |
请求参数:
|
名称 |
必填 |
类型 |
说明 |
|
key |
是 |
String |
接口请求key |
|
ip |
是 |
String |
查询的IPv4地址,如:58.215.154.11 |
返回参数:
|
名称 |
类型 |
说明 |
|
error_code |
Int |
返回码,0表示成功 |
|
reason |
String |
描述 |
|
result |
Object |
结果 |
|
country |
String |
国家/地区,(部分记录可能为空) |
|
province |
String |
省份区域,(部分记录可能为空) |
|
city |
String |
城市,(部分记录可能为空) |
|
isp |
String |
运营商,(部分记录可能为空) |
返回示例参考:
{
"error_code": 0,
"reason": "查询成功",
"result": {
"country": "中国",
"province": "江苏",
"city": "无锡",
"isp": "电信"
}
}
状态码参考(error_code):
|
状态码 |
说明 |
|
0 |
请求成功 |
|
200101 |
查询的IPv4地址不能为空 |
|
200102 |
查询的IPv4地址格式不正确 |
|
200103 |
查询不到相关记录 |
|
— |
— |
|
10001 |
接口请求Key校验不通过 |
|
10008 |
请求的IP不在白名单 |
|
10009 |
接口请求Key状态异常 |
|
10012 |
请求超过次数限制 |
|
10014 |
系统内部异常 |
|
10020 |
接口维护 |
|
10021 |
接口停用 |
|
10023 |
请求频次过快,请稍后再试 |