1. 接入三方 Token

• token 格式要求及对接配置位置

# 头部/Header

{
  "typ": "JWT",
  "alg": "HS256"
}

# 载荷/Payload

{
  "username": "test1008",
  "id": 1008,
  "iss": "localhost:2999", // 发放方
  "aud": "localhost:2999", // 接收方
  "iat": 1763223109,  // 签发时间
  "nbf": 1763223109, // 生效时间
  "exp": 1794759109, // 过期时间
  "jti": "1008_user" // 格式要求：{id}_user
}

# 对接生成/配置位置 后端项目/.env 文件 。更改后 后端需要重启项目

# JWT 密钥 32位
JWT_SECRET = MJQXGZJTGLSYVIHFV6DORJ5D4WXYM4Y=
# JWT 对称加密算法（HS256, HS384, HS512）
JWT_ALGO = HS256

2. 创建用户

接口地址：POST /home/base/parseUserToken

认证：无

请求参数：

参数名	类型	必填	说明
token	String	是	用户 Token（JWT 格式）

响应示例：

{
  "code": 1,
  "msg": "登录成功"
}

说明：

• 此接口用于通过 JWT Token 创建用户信息
• 如果用户不存在，会自动创建用户（类型为普通用户，user_type=2）

3. 用户注销条件

接口地址：/home/cancellation/check

认证：需要登录

响应示例：

{
  "code": 1,
  "msg": "满足注销条件"
}

错误响应示例：

{
  "code": 0,
  "msg": "用户不存在" // 其余状态公示：存在商铺无法注销，请先注销商户、账户余额不为0，无法注销
}

说明：

• 检查用户是否满足注销条件
• 不满足条件会返回具体原因

4. 用户注销确认

接口地址：/home/cancellation/cancel

认证：需要登录

请求参数：

参数名	类型	必填	说明
reason	String	否	注销原因

响应示例：

{
  "code": 1,
  "msg": "注销成功"
}

说明：

• 注销前会再次检查注销条件
• 注销后会立即返回 注销成功提示，并后台队列清理用户相关数据
• 注销操作不可逆