 yml2213
|
c015def4cd
|
优化后台UI与开放文档排版设计
|
2026-08-04 11:01:52 +08:00 |
|
|
yml2213
|
d6b426ab2a
|
查询绑定结果增加预期账号比对：mismatch 提前拦截
- 下单 data 传了 game_account 时，bind-result 返回 expected_game_account 与 mismatch
- 绑定账号与预期不一致时 message 提示，配合 submit 已有的一致性校验提前发现
- 对接文档补充 mismatch 字段与说明
|
2026-08-03 17:47:12 +08:00 |
|
|
yml2213
|
19ada1282e
|
新增查询绑定结果接口（自建发货页轮询角色信息）
- GET /api/client/v1/orders/{order_no}/delivery/bind-result?bind_uuid=xxx
- 返回 bound/game_account/role_name/game_channel；未绑定返回 bound=false（不报错，供轮询）
- 对接文档自建发货页模式新增该接口，注明轮询建议间隔
|
2026-08-03 17:10:50 +08:00 |
|
|
yml2213
|
8da9dcec43
|
发货订单列表移除上游单号列，文档弱化内部发货单号
- 前端订单表格删除「上游单号」列（商户无需关注）
- 对接文档 provider_order_no 标注为平台内部发货单号
- 后端 provider_order_no 保留（防重复发货标记）
|
2026-08-03 16:31:50 +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
|
a44f58cd0f
|
优化开放 API 文档：创建订单响应示例补全为真实完整字段
- 响应示例从 4 个字段补全为完整订单对象（product/金额/手续费/时间等 21 字段）
- 备注补充双单号说明：下单后保存 order_no 用于后续链路，client_order_no 仅用于幂等
- 说明 data 透传字段行为
|
2026-08-03 13:53:18 +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
|
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
|
4165fc4d01
|
优化api文档
|
2026-07-30 15:44:08 +08:00 |
|