Northern_Lights
da24448000
Some checks failed
deploy and publish / build-and-deploy (push) Has been cancelled
revert delete all
158 lines
3.6 KiB
Markdown
158 lines
3.6 KiB
Markdown
# 通过ip确定地理位置
|
||
|
||
## 根据请求IP确定属地
|
||
|
||
> https://api.bilibili.com/x/web-interface/zone
|
||
>
|
||
> https://api.live.bilibili.com/xlive/web-room/v1/index/getIpInfo
|
||
>
|
||
> https://app.bilibili.com/x/resource/ip
|
||
|
||
*请求方式：GET*
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ------- |
|
||
| code | num | 返回值 | 0：成功 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ---- | ------------- | ------------ |
|
||
| addr | str | 公网IP地址 | |
|
||
| country | str | 国家/地区名 | |
|
||
| province | str | 省/州 | 非必须存在项 |
|
||
| city | str | 城市 | 非必须存在项 |
|
||
| isp | str | 运营商名 | |
|
||
| latitude | num | 纬度 | |
|
||
| longitude | num | 经度 | |
|
||
| zone_id | num | ip数据库id | 第二个接口无 |
|
||
| country_code | num | 国家/地区代码 | 第二个接口无 |
|
||
|
||
**示例：**
|
||
|
||
```shell
|
||
curl 'https://api.bilibili.com/x/web-interface/zone'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code":0,
|
||
"message":"0",
|
||
"ttl":1,
|
||
"data":{
|
||
"addr":"36.40.120.145",
|
||
"country":"中国",
|
||
"province":"陕西",
|
||
"city":"渭南",
|
||
"isp":"电信",
|
||
"latitude":34.4995,
|
||
"longitude":109.492821,
|
||
"zone_id":4472912,
|
||
"country_code":86
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 查询任意 IP 地址的归属地
|
||
|
||
> https://api.live.bilibili.com/ip_service/v1/ip_service/get_ip_addr
|
||
> https://api.live.bilibili.com/client/v1/Ip/getInfoNew
|
||
|
||
注: 以上接口等效
|
||
|
||
*请求方式：GET*
|
||
|
||
**URL参数:**
|
||
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ------ | ---- | -------- | ------ | ---- |
|
||
| ip | str | IP地址 | 不必要 | IPv4或IPv6地址不限, 留空与[根据请求IP确定地理位置](#根据请求ip确定地理位置)基本相同 |
|
||
|
||
**JSON回复:**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ------- |
|
||
| code | num | 返回值 | 0: 成功 |
|
||
| message | str | 错误信息 | 默认为空 |
|
||
| msg | str | 错误信息 | 同message |
|
||
| data | obj | 信息本体 | 出错时为空数组 |
|
||
|
||
`data`对象：
|
||
|
||
与[根据请求IP确定地理位置](#根据请求ip确定地理位置)回复的`data`对象基本相同, 但无 `zone_id` `country_code` 字段
|
||
|
||
**示例:**
|
||
|
||
查询请求IP地址的归属地:
|
||
|
||
```shell
|
||
curl -G 'https://api.live.bilibili.com/client/v1/Ip/getInfoNew'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例:</summary>
|
||
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "",
|
||
"message": "",
|
||
"data": {
|
||
"addr": "104.28.156.113",
|
||
"country": "新加坡",
|
||
"province": "新加坡",
|
||
"city": "",
|
||
"isp": "cloudflare.com",
|
||
"latitude": "1.352083",
|
||
"longitude": "103.819836"
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
查询IP地址`8.8.8.8`的归属地:
|
||
|
||
```shell
|
||
curl -G 'https://api.live.bilibili.com/ip_service/v1/ip_service/get_ip_addr' \
|
||
--data-urlencode 'ip=8.8.8.8'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例:</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "",
|
||
"message": "",
|
||
"data": {
|
||
"addr": "8.8.8.8",
|
||
"country": "GOOGLE.COM",
|
||
"province": "GOOGLE.COM",
|
||
"city": "",
|
||
"isp": "level3.com",
|
||
"latitude": "",
|
||
"longitude": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|