diff --git a/src/api/user/user.ts b/src/api/user/user.ts index 70311ac..f79c6c1 100644 --- a/src/api/user/user.ts +++ b/src/api/user/user.ts @@ -81,6 +81,25 @@ export interface EmployeeInfo { [key: string]: any } +/** + * 获取用户信息入参(`user.info`) + */ +export interface UserInfoParams { + /** 端标记,后端用于区分会话来源(小程序端固定 mobile) */ + device?: string + /** + * 小程序 AppID(**字符串**,形如 `wx3xxxxx`) + * + * 与 `wechat.loginByCode` 的 `appid` 同源:本项目作为开放平台第三方平台模板发布, + * 各仓库授权后 AppID 不同且**运行时才确定**(`wx.getAccountInfoSync()`), + * 上报后由后端 `resolveWechatApp()` 反查 `wms_wechat_app` 授权记录。 + * + * ⚠️ 是 AppID 字符串,**不是** `wms_wechat_app.id`(整数主键)。 + */ + wechat_appId?: string + [key: string]: any +} + /** 用户信息:后端字段随业务扩展,此处只声明稳定字段,其余用索引签名兜住 */ export interface UserInfoResult { employees_id?: number @@ -141,6 +160,52 @@ export interface WechatLoginResult { user: WechatUserInfo } +/** + * 更新微信账号资料入参(`wechat.updateInfo`) + * + * 后端语义:**仅未绑定真实用户的微信账号**可调用(已绑定账号不支持修改), + * 字段**可部分更新** —— 传哪个改哪个。 + */ +export interface WechatUpdateInfoParams { + /** 昵称(≤255 字符) */ + nickname?: string + /** 头像 URL(≤500 字符),一般由 `wechat.uploadHeadimg` 回写后带回 */ + headimgurl?: string +} + +/** 微信账号资料(`wechat.updateInfo` / `wechat.uploadHeadimg` 的返回) */ +export interface WechatProfileResult { + /** `wms_user_oauth.id` */ + oauth_id: number + /** 更新后的昵称 */ + nickname?: string + /** 更新后的头像 URL */ + headimgurl?: string + /** 仅 `wechat.uploadHeadimg` 返回,值与 `headimgurl` 相同 */ + url?: string +} + +/** + * 我的登录码响应(`wechat.getMyLoginCode`) + * + * ⚠️ 实测响应是**扁平**的 —— 业务字段与 `flag/code/message` **同级**,**没有 `data` 包裹**: + * ```json + * { "flag":"success","code":1,"message":"获取成功", + * "login_code":"eyJ1dWlkIjoiMl82NTU5MzIiLCJmb3JtIjoid2VjaGF0In0=","oauth_id":2,"timestamp":1790065001 } + * ``` + * (`login_code` 解码后为 `{"uuid":"2_655932","form":"wechat"}`) + * + * 故下面的字段声明的是**响应顶层**字段;调用方(store)按顶层取值, + * 并兼容将来被包进 `data` 的情况。 + */ +export interface WechatLoginCodeResult { + /** 登录码:`uuid={id}_{6位随机}`、`form=wechat` 的 JSON base64 */ + login_code?: string + /** `wms_user_oauth.id` */ + oauth_id?: number + [key: string]: any +} + // ────────────────────────────── 接口 ────────────────────────────── /** 账号密码登录 */ @@ -169,11 +234,11 @@ export function register(data: UserRegisterParams): Promise> { * 也是**微信登录态的探测接口**:未绑定的微信登录(token 里 `id=0`)调用它不会 401, * 而是返回 `is_bound: false` + 微信层信息。 * - * @param data 额外入参(默认带 device) + * @param data 入参:`device`、**`wechat_appId`**(小程序运行时真实 AppID) * @param token 显式指定 token —— 微信登录未绑定时 token 只存内存、未落地,需手工带上 */ export function getInfo( - data: Record = {}, + data: UserInfoParams = {}, token?: string ): Promise> { return request({ @@ -286,3 +351,79 @@ export function wechatPushLoginCode(data: { redirectOn401: false }) } + +/** + * 更新微信账号资料(**微信登录态中间层**:带微信登录态 token 即可,未绑定真实用户也可调用) + * + * 用途:小程序端「未绑定 WMS 账号」时,让用户补全自己的**微信昵称 / 头像**。 + * 微信自 2022-10 回收了 `getUserProfile`,头像昵称必须由用户主动提供 + * (`