1.1.2 升级说明
本文对应仓库中的 @hfyidu/api@1.1.2,说明请求头、推广查询及认证重试的行为变化。
请求头与推广查询
setupHttpApi新增可选realAppId: string,在业务请求和登录刷新请求中发送X-Real-App-ID。原有appId、identityAppId保持独立。SpreadInfoQueryParams支持{ spread_id: number }或{ short_code: string },两个字段互斥且必须提供其中一个。原有仅传推广 ID 的调用继续有效,详见推广接口。
认证与会话行为
- 单次
request()的认证重试、续期重试各最多一次;两者交错时最多三次业务请求,不含登录刷新。重试失败后向调用方抛错。 - 需 token 的并发请求共享登录刷新;
tokenRequired: false的请求不等待刷新,也不自动登录或续期重试。 - 自动刷新先调用桥接
setToken并更新内存 token,再调用loginRefreshHandler。依赖旧回调顺序的代码需要调整。 - 主动登录、退出、切换账号时同步更新 store 并调用
httpApi.setAccessToken()。该方法会使旧会话刷新结果失效,阻止旧会话继续认证重试,但不取消已发出的请求。自动刷新回调中不要再次调用此方法。 - 整个重试链由公共请求入口统一提示错误;
ignore: true关闭提示但保留异常。 - 普通接口增加响应结构校验,登录刷新及续期校验非空 token。formatter 判空仅针对
null、undefined,允许0、false、空字符串进入 formatter。
完整会话同步示例和 builder 使用限制见快速开始。
小程序示例调整
wxmini 的主动登录流程不再额外注入调试字段 flag: 'devlopment',同时移除登录成功结果日志。会话 store 的类型导入和注释清理不改变其业务行为。
文档对应当前源码,不代表版本已发布到 npm;发布后再在业务项目升级依赖。