Skip to content

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;发布后再在业务项目升级依赖。

内部工具包 · 未开源授权,仅限公司内部授权团队使用