IP归属地查询接口
在2022年5月初,网络上各大平台上,都开始展示用户IP属地,在某音、某手等小视频平台以及各主流网站应用中,都展示IP归属地,如下图所示:
接口描述
使用者调用该接口,可以传入IP将返回指定IP地址的归属地,如果不传入参数,将会返回请求者IP地址的归属地。
注意:只能查国内,国外会返回未知。
接口地址
javascript
https://tea.qingnian8.com/tools/placename
https://tea.qingnian8.com/tools/placename
请求方式
javascript
GET
GET
请求参数
参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
---|---|---|---|---|
ip | 119.163.220.145 | 否 | String | 输入要查询的IP地址 |
秘钥验证
参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
---|---|---|---|---|
access-key | 556688 | 是 | String | 放到请求头(Header)里面。 微信扫码看广告,获得秘钥参数。 |
响应示例
javascript
{
"errCode": 0,
"errMsg": "查询成功",
"data": "山东",
"timeCost": 1
}
{
"errCode": 0,
"errMsg": "查询成功",
"data": "山东",
"timeCost": 1
}
参数名 | 参数类型 | 描述说明 |
---|---|---|
errCode | Integer | 0:成功 400:请求失败 |
errMsg | String | 查询结果描述 |
data | String | IP归属地名称 |
timeCost | Integer | 接口消耗时间 |