基本信息
接口名称：
高精度IP查询
请求方法：
GET
计费类型：
免费
接口文档
# 高精度IP查询API
## 接口说明
高精度IP地址归属地查询接口，支持多个权威数据源，提供准确的IP地理位置信息。
## 请求地址
`GET /api/myip`
## 请求方法
`GET`
## 请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|-------|------|------|------|------|
| apikey | string | 是 | API密钥 | 用户中心获取 |
| ip | string | 否 | 要查询的IP地址 | 8.8.8.8 |
**注意：** 如果不传 `ip` 参数，系统将自动获取请求客户端的IP地址进行查询。
## 响应格式
### 成功响应
```json
{
"status": "success",
"code": 200,
"message": "查询成功",
"data": {
"ip": "8.8.8.8",
"country": "美国",
"country_id": "US",
"region": "加利福尼亚州",
"region_id": "CA",
"city": "山景城",
"city_id": "",
"county": "",
"county_id": "",
"isp": "Google LLC",
"isp_id": "",
"area": "",
"area_id": "",
"address": "美国 加利福尼亚州 山景城",
"location": {
"lat": "37.4056",
"lng": "-122.0775"
},
"data_source": "taobao"
},
"timestamp": 1640995200,
"api_version": "1.0.0"
}
```
### 错误响应
```json
{
"status": "error",
"code": 400,
"message": "IP地址格式不正确",
"timestamp": 1640995200
}
```
## 数据源说明
本接口使用多个权威数据源，按以下优先级进行查询：
1. **淘宝IP库** - 精度最高，数据最全
2. **IP2Region** - 备用数据源
3. **太平洋网络** - 第三备用数据源
## 支持的IP类型
- IPv4 地址
- IPv6 地址
- 公网IP和内网IP
## 使用示例
### 查询指定IP
```bash
curl "https://yourdomain.com/api/myip?apikey=your_api_key&ip=8.8.8.8"
```
### 查询客户端IP
```bash
curl "https://yourdomain.com/api/myip?apikey=your_api_key"
```
## 错误码说明
| 错误码 | 说明 |
|--------|------|
| 200 | 查询成功 |
| 400 | 参数错误 |
| 401 | API密钥无效 |
| 429 | 请求频率超限 |
| 500 | 服务器内部错误 |
## 计费说明
- 计费模式：混合模式（支持按量付费和资源包）
- 按量费用：每次查询 0.002 元
- 支持购买资源包获得更优惠价格
## 注意事项
1. 请妥善保管您的API密钥
2. 建议设置IP白名单增强安全性
3. 查询结果会根据不同数据源略有差异
4. 内网IP可能无法获取详细地理信息
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| ip | 否 | string | 要查询的IP地址，不传则自动获取客户端IP | 8.8.8.8 |
请求示例
{
"ip": "8.8.8.8"
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | string | 请求状态 |
| code | number | 状态码 |
| message | string | 返回消息 |
| data | object | IP信息数据 |
| timestamp | number | 时间戳 |
| api_version | string | API版本 |
返回示例
{
"status": "success",
"code": 200,
"message": "查询成功",
"data": "{}",
"timestamp": 1640995200,
"api_version": "1.0.0"
}