API 文档
基础地址 https://wq.1molchuan.top。所有响应为 JSON,Content-Type: application/json; charset=utf-8。无需密钥。
数据字段
| 字段 | 类型 | 说明 |
|---|---|---|
ip | string | 规范化后的地址 |
version | number | 4 或 6 |
mainland | boolean | 是否属于中国大陆的运营商网络 |
isp | string | null | 运营商代码:telecom / unicom / mobile / cernet / cloud;大陆以外为 null |
isp_name | string | null | 运营商名称,如 China Telecom |
接口
GET /v1/ip
查询调用方的出口地址。
curl https://wq.1molchuan.top/v1/ip
GET /v1/ip/{address}
查询指定地址。
curl https://wq.1molchuan.top/v1/ip/223.5.5.5
{ "ip": "223.5.5.5", "version": 4, "mainland": true, "isp": "cloud", "isp_name": "Cloud / IDC" }
GET /v1/lookup?ip={address}
查询形式,等价于上一个接口。
curl "https://wq.1molchuan.top/v1/lookup?ip=8.8.8.8"
{ "ip": "8.8.8.8", "version": 4, "mainland": false, "isp": null, "isp_name": null }
POST /v1/lookup
批量查询,请求体为 JSON {"ips": [...]},一次最多 100 个。
curl -X POST https://wq.1molchuan.top/v1/lookup \
-H "content-type: application/json" \
-d '{"ips":["114.114.114.114","2400:3200::1"]}'
{ "results": [
{ "ip": "114.114.114.114", "version": 4, "mainland": true, "isp": "telecom", "isp_name": "China Telecom" },
{ "ip": "2400:3200::1", "version": 6, "mainland": true, "isp": "cloud", "isp_name": "Cloud / IDC" }
] }
错误码
错误响应为 { "error": { "code": "...", "message": "..." } }。
| HTTP | code | 说明 |
|---|---|---|
| 400 | missing_parameter | 缺少必填参数 |
| 400 | invalid_parameter | 参数不是合法的 IPv4 / IPv6 地址 |
| 400 | invalid_address | 地址无法解析 |
| 400 | invalid_json | 请求体不是合法 JSON |
| 401 | unauthorized | 密钥缺失或无效 |
| 403 | forbidden | 无权访问 |
| 404 | not_found | 接口不存在 |
| 405 | method_not_allowed | 方法不支持 |
| 413 | payload_too_large | 请求过大 |
| 415 | unsupported_media_type | Content-Type 不支持 |
| 429 | rate_limited | 请求过于频繁 |
| 503 | unavailable | 数据加载中,稍后重试 |