1. 公网 IP 地址查询
API 介绍
公网 IP 地址查询 API 提供了获取客户端当前公网 IP 地址的功能。通过这个 API，用户可以方便地获取其设备的公网 IP 地址，这对于调试、记录和网络配置等场景非常有用。
API 端点
- URL:
https://ip-info.cn/api/ip/ - 方法:
GET
响应格式
- 内容类型:
application/json - 状态码:
200 OK
响应字段说明
- ip: 当前客户端的公网 IP 地址。例如
119.191.127.253。 - status: 响应状态码。例如
200表示请求成功。
示例响应
请求
curl "https://ip-info.cn/api/ip/"响应
{
"ip": "119.191.127.253",
"status": 200
}响应字段解释
- ip:
119.191.127.253表示当前客户端的公网 IP 地址。 - status:
200表示请求成功，响应状态码为 200。
使用场景
- 网络调试: 获取公网 IP 地址用于调试和排除网络连接问题。
- 记录日志: 记录设备的公网 IP 地址以备查找和审计。
- API 调用: 在需要根据客户端 IP 地址执行特定操作的场景中，获取并使用此 IP 地址。
2. IP 地址信息查询
API 介绍
IP 地址信息查询 API 提供了获取指定 IP 地址的地理位置和其他相关信息的功能。通过这个 API，用户可以查询任意 IP 地址的详细信息，包括地址范围、ASN 信息、国家和区域等。
API 端点
- URL:
https://ip-info.cn/api/query/?ip=<IP_ADDRESS> - 方法:
GET
响应格式
- 内容类型:
application/json - 状态码:
200 OK
响应字段说明
- ip: 查询的 IP 地址。
- addr: IP 地址的地址范围。例如
223.4.0.0/14。 - asn: ASN（自治系统编号）信息。
- info: ASN 归属的信息，例如
阿里云。 - name: ASN 的名称，例如
Hangzhou Alibaba Advertising Co.,Ltd.。 - number: ASN 编号，例如
37963。 - country: 国家信息。
- code: 国家代码，例如
CN。 - name: 国家名称，例如
中国。 - regions: 相关的地理区域列表。例如
["浙江省", "杭州市"]。 - regions_short: 地理区域的简称列表。例如
["浙江", "杭州"]。 - type: IP 地址类型，例如
数据中心。
示例响应
请求
curl "https://ip-info.cn/api/query/?ip=223.5.5.5"响应
{
"addr": "223.4.0.0/14",
"asn": {
"info": "阿里云",
"name": "Hangzhou Alibaba Advertising Co.,Ltd.",
"number": 37963
},
"country": {
"code": "CN",
"name": "中国"
},
"ip": "223.5.5.5",
"regions": [
"浙江省",
"杭州市"
],
"regions_short": [
"浙江",
"杭州"
],
"type": "数据中心"
}响应字段解释
- ip:
223.5.5.5表示查询的 IP 地址。 - addr:
223.4.0.0/14表示该 IP 地址的地址范围。 - asn:
- info:
阿里云表示 ASN 归属的信息。 - name:
Hangzhou Alibaba Advertising Co.,Ltd.表示 ASN 的名称。 - number:
37963表示 ASN 编号。 - country:
- code:
CN表示国家代码。 - name:
中国表示国家名称。 - regions:
["浙江省", "杭州市"]表示该 IP 地址所在的地理区域。 - regions_short:
["浙江", "杭州"]表示该 IP 地址所在区域的简称。 - type:
数据中心表示该 IP 地址的类型。