IP 归属地查询 API 文档

1. 接口概述

该 API 用于查询指定 IP 地址的归属地信息，返回包括国家、省份、城市和网络服务提供商等信息。

2. 接口基本信息

• 接口地址：https://api.hueoo.com/v1/czdb/
• 请求方法：GET
• 接口版本：v1
• 响应格式：JSON

3. 请求参数

参数名	类型	必填	描述
ip	string	否	要查询归属地的 IP 地址。如果未提供该参数，将默认使用访问者的 IP 地址进行查询。

4. 请求示例

GET https://api.hueoo.com/v1/czdb/?ip=1.15.21.19 HTTP/1.1
Host: api.hueoo.com
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36
Accept: application/json

5. 响应参数

参数名	类型	描述
country	string	IP 地址所属的国家。
province	string	IP 地址所属的省份（若有）。
city	string	IP 地址所属的城市（若有）。
provider	string	IP 地址对应的网络服务提供商（若有）。

6. 响应示例

{
    "country": "中国",
    "province": "上海",
    "city": "上海",
    "provider": "腾讯云"
}

当请求的 IP 地址只返回国家和网络服务提供商信息时，响应示例：

{
    "country": "澳大利亚",
    "province": "",
    "city": "",
    "provider": "APNIC/CloudFlare公共DNS服务器"
}

7. 错误处理

错误码	描述
400	如果请求参数格式不正确（例如 IP 地址格式错误），返回该错误码。
500	内部服务器错误，通常表示服务器在处理请求时遇到了问题。