1.1.1 升级说明
本文对应仓库中的 @hfyidu/api@1.1.1,说明运行环境选择和微信网页授权配置。
运行环境
setupHttpApi 新增可选字段 plateform: 'web' | 'miniapp',默认 miniapp。字段名保留现有拼写 plateform。
没有自定义 auth.loginParamsBuilder 时,小程序调用 uni.login 构造 theatre_code,网页使用微信服务号授权构造 wxoa_code。原有自定义 builder 优先级不变。
微信 H5 接入
H5 应用设置 plateform: 'web',并在请求前调用 setupWxAuth({ appId }),其中 AppId 为服务号 AppId,不是后台请求头的业务 AppId。新增公开配置类型 WxAuthConfig 和函数 setupWxAuth、getWxAuthConfig,可从 @hfyidu/api/http 或全量入口导入。
redirectUri 可选,默认回调地址为 https://web.auth.ax3672.cn/callback/web,附带当前页面地址;snsapi 默认为 snsapi_base,也可设置 snsapi_userinfo。自定义回调 URL 原样编码使用,需要业务侧负责回到正确页面并保留推广参数。
未配置有效服务号 AppId 时,内置网页登录抛出明确初始化错误。自定义 loginParamsBuilder 可绕过内置网页登录。
完整接入示例见快速开始。
修复
- 文件上传显式传入
headerBuilder({}, true),使用带 token 的请求头并修复类型检查错误。 WeChatAuth.authorize()保留默认静默授权参数,原有无参调用继续有效。- 初始化 HTTP 配置时复制配置并设置默认运行环境,避免修改调用方传入的对象。
此文档更新不代表版本已发布到 npm;发布后再在业务项目升级依赖。