Commit Graph
21 Commits
Author SHA1 Message Date
yml2213 c015def4cd 优化后台UI与开放文档排版设计 2026-08-04 11:01:52 +08:00
yml2213 90e5690a0a 对接文档移除顶部「开放 API/API 密钥」切换按钮,统一由左侧目录导航 2026-08-03 16:07:31 +08:00
yml2213 b7b9132242 对接文档重构:两种发货对接方式分开展示
- 左侧目录按分组展示:基础接口 / 发货链接模式 / 自建发货页模式 / 回调 / 附录
- 概述页发货对接方式对比表强化(适用场景/接口顺序/建议)
- 创建订单响应示例 data 统一为约定字段,补充 201/200 状态说明
- 对外响应字段 upstream_order 更名为 delivery(result_data 存储键兼容旧数据)
2026-08-03 14:48:30 +08:00
yml2213 4019b657c4 对接文档去除上游概念,只展示商户对接平台
- 文档移除所有上游/发货平台/BFF 表述:接口字段说明、示例、推荐流程全部中性化
- 代码用户可见文案同步中性化:提交发货 message、错误提示、发货配置相关措辞
- 概述去掉 /api/open/v1 上游链路提示
2026-08-03 14:34:58 +08:00
yml2213 f95075e2e4 data 透传闭环:发货数据回显、回调带回,并限制 2KB
- 「查询发货数据」响应新增 data(下单透传原样回显,供自建发货页预填/展示)
- 回调 payload 带回 data(下单传 → 回调收,商户对接免回查)
- 创建订单 data 限制最长 2048 字节
- 文档更新:data 用途(自建页预填/回调/上游查单约定字段)、发货数据与回调示例
- 单测覆盖 data 回显
2026-08-03 14:32:08 +08:00
yml2213 ef8b8a7213 回调签名改为与开放 API 一致的字典序拼接风格
- 签名串由 timestamp+换行+bodyhash 改为 body_sha256=<hash>&timestamp=<unix秒>(ASCII 字典序 & 拼接)
- 同步更新对接文档
2026-08-03 11:48:10 +08:00
yml2213 3e8526d5d7 对接文档新增回调通知章节(事件/签名/推送重试)
- 回调文档三个区块:回调通知(事件列表、推送示例、接收方要求)、签名校验(算法与伪代码)、推送与重试(微信式 16 次退避序列)
- 概述一句话上手补充回调配置步骤
2026-08-03 11:33:36 +08:00
yml2213 eac025c92f 加强发货提交可靠性并统一契约口径
- 发货提交记录阶段推进与失败分类,失败不再清空 result_data
- 超时巡检区分已提交上游与提交中断两类卡单,避免误判
- 已提交上游的失败订单禁止自动重发,防止重复发货
- ship_attempts 仅在 claim 时计数,失败阶段只记录分类信息
- CanFulfill 对已提交上游的失败单返回不可发货
- 删除预留的 pending 订单状态,统一订单状态模型
- 契约改名:order.fulfillment.updated -> order.shipping.updated,fulfillment:read -> shipping:read
- 文档修正 scope 为或关系
2026-07-31 18:42:52 +08:00
yml2213 4aa5258c2d 统一发货口径并保护结果数据 2026-07-31 17:45:20 +08:00
yml2213 04130e5ec8 统一订单单状态模型 2026-07-31 17:02:19 +08:00
yml2213 30362f14bd 简化开放下单幂等参数 2026-07-31 15:25:26 +08:00
yml2213 71cde7e32b 优化商户功能导航与表格 2026-07-31 15:08:26 +08:00
yml2213 371481126e 优化开放 API 文档界面 2026-07-31 14:16:29 +08:00
yml2213 949a0eb8f7 统一时间格式和时区 2026-07-31 12:57:17 +08:00
yml2213 667bfbde06 补开放接口文档 2026-07-31 12:29:43 +08:00
yml2213 5858ff59ae 修正发货回调流程 2026-07-30 19:35:34 +08:00
yml2213 881ef40fb7 refactor(openapi): 客户端签名统一为字典序+&拼接风格
- BuildOpenV1Sign 改为 app_key/body_sha256/method/nonce/path/timestamp
  按 ASCII 字典序用 & 拼接,与上游 BuildSignString 风格一致
- body 以 SHA256 摘要参与签名,避免大 body 与特殊字符问题
- 同步更新中间件调用点、测试用例与前端鉴权文档
2026-07-30 15:53:09 +08:00
yml2213 4165fc4d01 优化api文档 2026-07-30 15:44:08 +08:00
yml2213 83429456a6 实现多商户履约平台基础 2026-07-30 12:02:32 +08:00
yml2213 ee78b80cd3 优化签名排序逻辑 2026-07-20 16:34:23 +08:00
yml2213 89cdd32181 对接皮肤源头开放接口:查询、发货推送与 HMAC 签名鉴权
- 新增订单查询与发货结果推送开放接口,支持 can_ship 与幂等
- 鉴权采用 X-Api-Key + Timestamp + Nonce + HMAC-SHA256 签名
- 订单扩展发货字段与 ship_logs,管理端增加发货记录与开放文档页
2026-07-20 16:06:44 +08:00