API文档 - 深圳市武佳明智能科技有限公司

概述

深圳市武佳明智能科技有限公司 API 是一套 RESTful 接口，通过 HTTPS 协议提供全球 IP 地理位置查询服务。所有请求均通过 JSON 格式进行数据交换，支持 IPv4 和 IPv6 地址查询。

API 基础地址：https://api.ipdatabase.cn/v1

特性

• RESTful 设计，支持 GET/POST 请求
• JSON 响应格式
• 支持 IPv4 和 IPv6
• API Key 认证
• HTTPS 加密传输
• 毫秒级响应速度

快速开始

1. 获取 API Key

注册深圳市武佳明智能科技有限公司账号后，在控制台创建项目即可获取专属 API Key。

2. 发送查询请求

curl -X GET "https://api.ipdatabase.cn/v1/ip/8.8.8.8" \
  -H "X-API-Key: YOUR_API_KEY"

3. 解析响应

JSON Response

{
  "code": 0,
  "message": "success",
  "data": {
    "ip": "8.8.8.8",
    "country": "美国",
    "country_code": "US",
    "province": "加利福尼亚州",
    "city": "山景城",
    "isp": "Google LLC",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles"
  }
}

认证方式

所有 API 请求需要在 HTTP Header 中携带 API Key 进行认证：

X-API-Key: YOUR_API_KEY

请妥善保管您的 API Key，不要在客户端代码或公开仓库中暴露。

IP 查询接口

端点：GET /v1/ip/{ip}

查询指定 IP 地址的地理位置信息。如果不指定 IP，则查询请求方 IP。

路径参数

参数	类型	必填	说明
`ip`	string	可选	要查询的IP地址，支持IPv4/IPv6。不传则使用请求方IP

请求参数

查询参数

参数名	类型	必填	说明
`lang`	string	可选	返回语言，支持 `zh-CN`（简体中文）、`en`（英文），默认 `zh-CN`
`fields`	string	可选	指定返回字段，逗号分隔，如 `country,city,isp`

返回字段

字段名	类型	说明
`ip`	string	查询的IP地址
`country`	string	国家/地区名称
`country_code`	string	国家代码（ISO 3166-1 alpha-2）
`province`	string	省/州名称
`city`	string	城市名称
`district`	string	区/县名称（部分数据）
`isp`	string	运营商/ISP名称
`latitude`	number	纬度坐标
`longitude`	number	经度坐标
`timezone`	string	时区标识
`asn`	string	自治系统号（企业版及以上）

Python SDK

pip install wjm-sdk

from wjm import WJMClient

# 初始化客户端
client = WJMClient(api_key="YOUR_API_KEY")

# 查询IP
result = client.lookup("8.8.8.8")
print(result.country)  # 美国
print(result.city)     # 山景城

错误码

错误码	HTTP状态码	说明
`0`	200	请求成功
`1001`	400	请求参数错误
`1002`	401	API Key 无效或缺失
`1003`	403	无权访问该资源
`1004`	404	IP地址格式无效
`1005`	429	请求频率超限
`1006`	429	月查询额度已用尽
`5000`	500	服务器内部错误

限流说明

免费版 API 限制每秒 10 次请求；专业版限制每秒 100 次；企业版限制每秒 1000 次；定制版无限制。

超出频率限制时，API 将返回 429 状态码。建议在客户端实现指数退避重试策略。

开发者文档

概述

特性