一、API 基本信息

  • API 名称:IP 地址归属地查询

  • API 地址https://api.hueoo.com/v1/czdb/api

  • 请求方法:GET

二、请求参数

参数说明

参数名

类型

是否必填

描述

示例值

ip

string

待查询的 IP 地址

1.15.21.19

三、响应参数说明

1. 响应数据格式

JSON 格式

2. 字段说明

字段名

类型

描述

示例值

country

string

国家

中国

province

string

省份

上海(海外IP无数据)

city

string

城市

上海(海外IP无数据)

provider

string

服务提供商

腾讯云

四、请求与响应示例

1. 请求示例(URL)

plaintext

https://api.hueoo.com/v1/czdb/api?ip=1.15.21.19  

2. 响应示例(JSON)

json

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

五、错误处理

  • 成功状态:HTTP 状态码 200 OK,返回正常数据。

  • 客户端错误:HTTP 状态码 4xx(如参数缺失、IP 格式错误)。

  • 服务器错误:HTTP 状态码 5xx(如服务端异常)。

六、使用限制

  1. 请遵守 API 提供商的使用规范,避免频繁请求或恶意调用。

  2. 数据可能存在更新延迟,实际归属地以最新记录为准。