星河API星河 API 观测平台

访客信息 V2

GET 需密钥

访客信息的增强版：在 V1（IP、浏览器、操作系统）基础上增加 IP 归属地查询，公开接口，无需密钥即可调用。

调用地址

https://api.shurans.cn/api/visitor-v2

调用方式

GET

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

请求参数

本接口不接受任何查询参数，直接请求即可。

响应示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "ip": "49.76.131.151",
        "browser": { "name": "Edge", "version": "153.0.0.0" },
        "os": "Windows 10",
        "location": {
            "source": "ip2region",
            "country": "中国",
            "country_code": "CN",
            "province": "江苏省",
            "city": "无锡市",
            "district": "",
            "isp": "电信"
        },
        "time": "2026-10-16 01:07:14"
    },
    "meta": { "request_id": "7214361835712ec46e74081384fc82be" }
}

响应字段说明

字段说明
code 业务状态码，成功恒为 200
message 状态说明，成功恒为 ok
data.ip 访客 IP（经受信代理解析）
data.browser.name 浏览器名称，无法识别时为 未知
data.browser.version 浏览器完整版本号
data.os 操作系统及版本
data.location IP 归属地；IP 未被收录或归属地双库均不可用时为 null（其余字段不受影响）
data.location.source 命中的归属地数据库：czdb（纯真主库）| ip2region（备用库）
data.location.country 国家 / 地区，缺省为空字符串
data.location.country_code 两位国家码（如 CN），缺省为空字符串
data.location.province 省份 / 州，缺省为空字符串
data.location.city 城市，缺省为空字符串
data.location.district 区县，缺省为空字符串
data.location.isp 运营商，缺省为空字符串
data.time 服务器时间（Y-m-d H:i:s，服务器时区）
meta.request_id 本次请求的追踪 ID（32 位十六进制），同时随 X-Request-Id 响应头返回

© 2026 星河 API