微信登录接口

概述

用于小程序前端根据微信 code 换取用户登录 token 与基础用户资料。

基本信息

项目	内容
接口名称	微信登录
接口用途	根据微信 code 换取用户 token 与基础资料
调用方	小程序前端
请求方式	POST
请求路径	/auth/wechat-login
请求头要求	Content-Type: application/json

请求参数

参数	类型	必填	说明
code	string	是	微信登录 code
scene	string	否	进入场景

返回参数

参数	类型	说明
token	string	登录 token
userId	string	用户 ID
isPhoneBound	bool	是否已绑定手机号
nickName	string	用户昵称

成功响应示例

{"code":"0","message":"ok","data":{"token":"tk_xxx","userId":"u_001","isPhoneBound":false,"nickName":"灵妙儿游客"}}

失败响应示例

错误码

错误码	说明
A0003	微信登录失败，请重新进入小程序

接口约束

项目	说明
幂等要求	否
前后端同步规则	登录成功后前端持久化 token 并拉取首页聚合数据
缓存/刷新策略	token 本地缓存，失效后重新登录
一致性要求	强一致

前端接入说明

1. 小程序前端获取微信登录 code 后调用本接口。
2. 登录成功后持久化保存 token。
3. 根据返回的 isPhoneBound 判断是否需要引导用户绑定手机号。
4. 登录完成后立即拉取首页聚合数据。
5. 当本地 token 失效时，重新执行微信登录流程。