用户中心接口（11 模块 35 接口）

基础URL: https://tools.wktyl.com
维护: Xianyan 团队 | 更新时间: 2026-08-15
跳转: 任务/勋章/签到 → · 安全/账号 → · 运营/统计 →

职责：用户资料、互动行为（收藏/笔记/点赞）、数据看板、设备管理。

💡 本文档涵盖大量接口。如只关心"签到/任务/勋章"三系统，请先读 USER_TASK_GUIDE.md 了解整体流程，再回来看字段定义。

1. 通用约定

1.1 认证

所有接口需登录（公开主页除外），请求头携带 token: <user_token>。响应均使用统一格式 {code, msg, time, data}。

1.2 频率限制

2. 接口清单

2.1 用户信息

• GET /api/user_center/index — 个人面板（资料 + 在线状态 + VIP + 云空间 + 设备列表）
• POST /api/user_center/updateProfile — 修改昵称/签名/性别/生日等
• POST /api/user_center/uploadAvatar — 上传头像（建议先 POST CDN 拿 URL）
• GET /api/user_center/profile/{id} — 查看他人公开主页（无需登录）

2.2 签到系统（合并到 USER_TASK_GUIDE §签到）

2.3 收藏系统

• GET /api/user_center/favorites?type=...&page=... — 收藏列表（按类型）
• POST /api/user_center/addFavorite — 添加收藏
• POST /api/user_center/removeFavorite — 取消收藏
• POST /api/user_center/moveFavorite — 移动到分组
• POST /api/user_center/createGroup — 创建收藏分组
• GET /api/user_center/groups — 获取分组列表

2.4 笔记系统

• GET /api/user_center/notes?source_type=...&keyword=...&page=... — 笔记列表
• POST /api/user_center/addNote — 新建笔记（关联来源）
• POST /api/user_center/updateNote — 修改
• POST /api/user_center/deleteNote — 删除
• GET /api/user_center/noteBySource/{type}/{id} — 查某来源的笔记

2.5 点赞系统

• POST /api/user_center/like — 点赞（通用）
• POST /api/user_center/unlike — 取消点赞
• GET /api/user_center/likes?type=... — 我点过赞的内容

2.6 通用互动（18 种操作，零新增表）

• POST /api/user_center/interact — 通用互动接口，action 字段决定行为：

2.7 数据面板

• GET /api/user_center/dashboard — 主数据面板（活动热力图、活跃度、分类分布）
• GET /api/user_center/heatmap?year=2026 — 年度学习热力图（GitHub 风格）
• GET /api/user_center/calendarStats?month=202608 — 月度日历统计（签到/笔记/活动）
• GET /api/user_center/categories — 个人内容分类分布

2.8 金币系统

• GET /api/user_center/coins?type=earn|spend&page=... — 金币流水
• GET /api/user_center/coinsSummary — 收支汇总（今日 / 本周 / 本月 / 累计）

2.9 公开主页

• GET /api/user_center/public/{id} — 用户公开主页（无需登录）
• GET /api/user_center/public/{id}/favorites — 他人公开收藏
• GET /api/user_center/public/{id}/badges — 他人公开勋章

2.10 学习统计

• GET /api/user_center/studyStats?period=week|month|year — 学习时长 / 完成度 / 连续天数
• GET /api/user_center/studyRank — 学习排行（我的位置 + 前 100 名）

2.11 设备管理

• GET /api/user_center/devices — 我的设备列表（在线标记）
• POST /api/user_center/deviceRegister — 注册新设备（同 USER_SECURITY §2.7 参数）
• POST /api/user_center/kickDevice — 下线指定设备（强制失效该设备 token）
• POST /api/user_center/setMainDevice — 标记主设备

3. 核心示例

3.1 个人面板

GET /api/user_center/index
Header: token: eyJ0eXAi...

# 响应
{
  "code": 1,
  "data": {
    "user_id": 12345,
    "nickname": "Alice",
    "avatar_url": "https://cdn.xianyan.cc/u/12345.jpg",
    "vip": 1,                       // 0=普通 1=VIP 2=永久
    "cloud_space": { "used": 1024, "total": 5120 },  // MB
    "is_online": true,
    "devices": [
      { "device_id": "A1B2", "name": "iPhone 15", "platform": "ios", "online": true }
    ],
    "extra": { /* 不常用字段压到这里 */ }
  }
}

3.2 通用互动

POST /api/user_center/interact
Header: token: ...
Content-Type: application/json

{
  "target_type": "poem",          // poem / sentence / user / share ...
  "target_id": 8888,
  "action": "collect",
  "metadata": { "group_id": 3 }   // 可选，action 特定参数
}

4. 设计要点

• 统一互动接口：18 种互动行为收敛到 1 个 interact 接口，避免每种行为一个端点，便于扩展
• 公开主页免登录：第三方分享场景下用户隐私安全（只暴露基础信息）
• 设备管理是安全基石：kickDevice 强制失效该设备所有 token，用户改密码或怀疑被盗时可一键清场
• 数据面板分维度：主面板（综合）+ 热力图（连续性）+ 日历（月度）+ 学习（专用），每维度适合不同场景
• 签到/任务/勋章合并：见 USER_TASK_GUIDE.md，避免重复定义

5. 关联文档

• 用户安全（注册/登录/密码/OAuth）
• 用户运营（任务/勋章/签到 - 汇总）
• 成就系统（勋章稀有度/分类/隐藏）
• 用户运营（排行榜/积分金币）
• 统计与分析（活跃度指标）