1.1.3 升级说明
本文对应仓库中的 @hfyidu/api@1.1.3,主要补充促销商品查询、下单来源参数及支付类型导出。
促销商品查询
新增 OrderDomain.cases.promotion.run({ template_code?: string }),发送 GET order/promotion, 返回 { data: OrderPromotionDto[], updatedAt }。无需模板筛选时传入 {},不是分页接口。 新增公开类型 OrderPromotionQueryParams、OrderPromotionDto,字段与示例见订单文档。
促销 DTO 提供商品价格、币券、会员天数、微信虚拟商品及标签字段,并包含 isVip、obtain、give 计算属性。 实例浅冻结;当前 tagInfo 保留后台原始对象,不自动转为嵌套 DTO,展示标签可使用顶层 tagTitle。
下单来源与标签
OrderCreateBodyParams、OrderCreateNextBodyParams新增可选source_relation: number,具体关联含义按后台协议传入。PaySourceType新增PROMOTION(value 为3、code 为promotion)和BENEFIT(value 为9、code 为benefit),可通过source_term传入对应的.value。OrderProductsTagInfoDto.title新增后台tag映射。该字段没有默认值,后台省略时为undefined;原有tag字段继续保留。
支付类型公开导出
订单领域入口和全量入口现在导出米花、掌中付支付 DTO 及 OrderPayData 联合类型, 业务侧可直接导入,无需引用源码内部路径。具体类型见新版支付数据结构。 此次仅开放已有类型的导出,不改变 V2 解析器支持的支付渠道。
推广查询类型、JSSDK 配置、HTTP 模型和工具函数的其他改动仅涉及格式整理,无需额外迁移。
文档对应当前源码,不代表版本已经发布到 npm;发布后再在业务项目升级依赖。