You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
chenchuchuan
4eb15bd91a
feat(warehouse): 回调链路 —— 按 provider 的 SDK 入口 + HMAC 验签 + 统一出参
回调是仓方主动推送,SDK 不监听端口:OMS 暴露 HTTP(如 /user/callback/yqn),
取到 headers 与原始 body 后交给 SDK,SDK 只做「验签 + 解析」。
三处新增:
1. 入口 WarehouseSdk.webhook(provider, secret, headers, rawBody, nowMillis)
原来只能 warehouses(warehouseCode, conn).parseWebhook(...),但回调进来时
只有 provider、没有 warehouseCode。新入口按 provider 分派,不查账户。
2. 出参 WarehouseCallback
原 WarehouseEvent 只有 5 个字段,装不下退货的明细行 id / 处理方式,
也装不下入库实收量。改为「公共头 + 按业务分型载荷」:outbound / returns /
inbound 三个可空字段,按 eventType 取用;rawBody 原样保留供回溯。
提供指纹方法供宿主去重(报文无事件 id 时使用)。
3. 验签能力 WebhookSignatures
HMAC-SHA256 + Base64、恒定时间比较(避免时间差泄漏签名前缀)、
时间戳窗口校验、大小写不敏感的取头。
运去哪面单回调(API 149)实现:
signature = Base64(HmacSHA256(appSecret, appKey|timestamp|rawBody))
头:X-AppKey / X-Timestamp / X-Signature
时间戳单位文档未写明,按位数兼容秒与毫秒(<=10 位按秒),联调后收紧。
新增 YqnLabelCallbackParserTest(10 个):验签通过 / 篡改 body / 错误密钥 /
缺头 / 时间窗过期 / 头名大小写 / X-AppKey 回退 / 载荷解析 / 指纹 / 时间戳单位。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
| .. |
|
src/main/java/common/ecommerce/warehouse
|
feat(warehouse): 回调链路 —— 按 provider 的 SDK 入口 + HMAC 验签 + 统一出参
|
2 weeks ago |
|
pom.xml
|
feat(warehouse): 新增仓库域 SDK 内核与运去哪 P1 出库闭环
|
2 weeks ago |