IP 归属地

GET 需密钥

查询 IP 的归属地（国家 / 省份 / 城市 / 运营商等），公开接口，无需密钥即可调用。数据源为双库：优先纯真 czdb，不可用或未命中时自动回落 ip2region。

调用地址

https://api.shurans.cn/api/ip-location

调用方式

GET

# 请求头携带密钥
Authorization: Bearer <你的密钥>

请求参数

参数	必填	示例	说明
ip	可选	8.8.8.8	要查询的 IPv4 / IPv6 地址；省略时默认查询当前访客的 IP

响应示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "ip": "49.76.131.151",
        "source": "ip2region",
        "country": "中国",
        "country_code": "CN",
        "province": "江苏省",
        "city": "无锡市",
        "district": "",
        "isp": "电信"
    },
    "meta": { "request_id": "7214361835712ec46e74081384fc82be" }
}

响应字段说明

字段	说明
code	业务状态码，成功恒为 200
message	状态说明，成功恒为 ok
data.ip	实际查询的 IP（省略 ip 参数时为访客 IP）
data.source	命中的数据库：czdb（纯真主库）\| ip2region（备用库）
data.country	国家 / 地区，缺省为空字符串
data.country_code	两位国家码（如 CN），缺省为空字符串
data.province	省份 / 州，缺省为空字符串
data.city	城市，缺省为空字符串
data.district	区县，缺省为空字符串
data.isp	运营商，缺省为空字符串
meta.request_id	本次请求的追踪 ID（32 位十六进制），同时随 X-Request-Id 响应头返回