isp-lookup v1.2.0

API 文档

基础地址 https://wq.1molchuan.top。所有响应为 JSON,Content-Type: application/json; charset=utf-8。无需密钥。

数据字段

字段类型说明
ipstring规范化后的地址
versionnumber4 或 6
mainlandboolean是否属于中国大陆的运营商网络
ispstring | null运营商代码:telecom / unicom / mobile / cernet / cloud;大陆以外为 null
isp_namestring | 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": "..." } }。

HTTPcode说明
400missing_parameter缺少必填参数
400invalid_parameter参数不是合法的 IPv4 / IPv6 地址
400invalid_address地址无法解析
400invalid_json请求体不是合法 JSON
401unauthorized密钥缺失或无效
403forbidden无权访问
404not_found接口不存在
405method_not_allowed方法不支持
413payload_too_large请求过大
415unsupported_media_typeContent-Type 不支持
429rate_limited请求过于频繁
503unavailable数据加载中,稍后重试