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>×tamp=<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 |
|