微信公众号登录系统

GET 获取二维码

获取公众号二维码图片，展示在登录弹窗中供用户扫码关注。

// 成功响应
{
  "success": true,
  "data": {
    "qrcodeUrl": "/wechat-qrcode.jpg"
  }
}

POST 验证码登录

用户输入从微信获取的6位验证码，验证通过后返回 JWT Token 和用户信息。

// 请求参数（JSON）
{ "code": "123456" }

// 成功响应
{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "user": {
      "openid": "oV_xxxxx",
      "nickname": "用户昵称",
      "avatar": "https://wx.qlogo.cn/..."
    }
  }
}

// 失败响应
{
  "success": false,
  "message": "验证码无效或已过期"
}

GET 获取用户信息 需 Token

通过 Bearer Token 获取当前登录用户的详细信息。

// 成功响应
{
  "success": true,
  "data": {
    "user": {
      "openid": "oV_xxxxx",
      "nickname": "用户昵称",
      "avatar": "https://wx.qlogo.cn/..."
    }
  }
}

POST 每日签到 需 Token

用户每天可签到一次，每次获得 1 积分。重复签到返回已签到状态。

// 签到成功
{
  "success": true,
  "data": {
    "checked": true,
    "points": 1,
    "total": 5,
    "message": "签到成功"
  }
}

// 今日已签到
{
  "success": false,
  "data": {
    "checked": false,
    "total": 5,
    "message": "今天已签到"
  }
}

GET 查询积分 需 Token

查询当前用户的积分总数和今日是否已签到。

// 响应
{
  "success": true,
  "data": {
    "points": 5,
    "checkedToday": false
  }
}

POST 退出登录

退出当前登录状态，客户端清除 Token 即可。

{ "success": true, "message": "已退出登录" }

GET 健康检查

检测服务是否正常运行。

{ "status": "ok", "mode": "production" }

数据表结构

users — 用户表

verification_codes — 验证码表

checkins — 签到表