访客明细 API

获取访客的详细数据，包括全局统计、地理分布和详细访客记录。

👤 接口信息

• 接口路径: /visitor
• 请求方法: GET
• 响应格式: JSON

🚀 快速开始

基础调用

curl https://api.160621.xyz/v1/visitor

成功响应 200

{
  "code": 200,
  "status": "success",
  "message": "获取访客数据成功",
  "data": {
    "globalStats": {},
    "distribution": {},
    "detailedVisitors": [],
    "updateTime": "2026-07-13 20:00:00",
    "sampleSize": 856
  },
  "timestamp": 1736123456789
}

响应字段

字段	类型	说明
globalStats	object	全局访问统计
distribution	object	访客地理分布
detailedVisitors	array	详细访客记录
updateTime	string	数据更新时间（Asia/Shanghai）
sampleSize	number	抽样样本数量

⚠️ 错误处理

加载访客数据失败时返回 500：

{
  "code": 500,
  "status": "error",
  "message": "无法加载访客统计数据",
  "data": { "details": "错误信息" },
  "timestamp": 1736123456789
}

⚙️ 环境变量 / 依赖

依赖	说明
KV_DEFAULT	访客数据持久化 KV 存储