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.
4.6 KiB
4.6 KiB
易达云(EDAYUN)接入
当前状态:骨架
| 项 | 状态 |
|---|---|
| 模块 | ✅ warehouse-sdk-edayun 已建、已注册 |
| 适配器 / 工厂 | ✅ 类型就绪,能力位为空 |
| 获取 token | ✅ 已对接(POST /oauth/token) |
| 业务接口 | ⬜ 等文档 |
| 回调 | ⬜ 等文档 |
| 真机验证 | ⬜ 等测试环境 |
骨架阶段的行为:任何业务调用都会抛
WarehouseUnsupportedCapabilityException——这是有意为之,不返回空集合。
鉴权(已确认部分)
① POST /oauth/token
body: { "client_id": "OMS授权用户名", "client_secret": "密码" }
无业务请求头
→ 返回 token
② 业务请求头
token 来自 ①
appKey 测试: 7289ded35b198243883151876eaf3213
timestamp 毫秒,5 分钟内有效
sign MD5(body + "." + appSecret),测试环境可传 openApiAdminSecret 免签
凭据映射(复用 ChannelSecret):
| 易达云 | ChannelSecret |
|---|---|
| appKey(请求头) | appKey() |
| appSecret(签名用) | appSecret() |
| client_id(换 token) | clientId() |
| client_secret(换 token) | clientSecret() |
代码位置:
| 类 | 职责 |
|---|---|
auth/EdayunTokenClient |
换 token,兼容三种响应形态,按 code 区分可重试 |
http/EdayunRequestFactory |
构造 token 请求与业务请求;sign() 算 MD5 |
adapter/EdayunAdapter.token(ctx) |
走 TokenManager 缓存(按 appKey + clientId 维度) |
真机验证(2026-11-12,PR 环境):
POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
Content-Type: application/json
{"client_id":"openapi-test","client_secret":"123456"}
→ HTTP 200
{"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
| 之前不确定的 | 实测结论 |
|---|---|
| 响应体结构 | 扁平结构,没有 code、没有 data 包裹 |
| 业务码 | 不返回 code;HTTP 200 + 有 access_token 即成功 |
| 有效期 | 响应里没有有效期字段(文档说「永久,建议留窗口刷新」) |
| refreshToken | 不返回 |
因此实现调整为:
- 缺
code不算失败,交给「有没有 access_token」判断 expiresAt是估算值(按 2 小时兜底),作用只是让TokenManager定期重登一次,不是真的到期- 兼容分支(
data.access_token/ 顶层token)保留,生产确认后可删
待确认(问易达云)
| # | 要确认 |
|---|---|
| 1 | 业务接口文档(含回调) |
| 2 | 测试环境:域名、OMS 授权账号、测试仓、测试 SKU |
| 3 | token 响应的实际 body 结构与有效期 |
| 4 | 限流:每秒许可数、单日配额 |
| 5 | 能否在 PR 环境走写操作(建单 / 取消 / 销毁),决定探针设计 |
| 6 | 回调:验签算法、时间戳单位、响应体格式、是否按路径区分 |
| 7 | 费用口径:是否有费用类型码(运去哪只有中文名) |
| 8 | 库存同步:支持按时间增量还是只能全量 |
骨架已定的部分
warehouse-sdk-edayun/
├── pom.xml
└── src/main/java/common/ecommerce/edayun/
├── EdayunConstants.java 端点 / 路径 / 限流(带 TODO 占位)
├── adapter/
│ ├── EdayunAdapter.java 能力位为空,未实现能力不声明
│ └── EdayunAdapterFactory.java
├── dto/package-info.java 一个接口一个文件
├── enums/package-info.java 平台枚举约定
├── http/package-info.java 信封校验约定
└── webhook/package-info.java 回调约定
测试:EdayunAdapterTest(5 个)验证类型接对、能力位为空、
未实现能力显式拒绝、注册后可解析、能力查询不触发真实 API。
接下来怎么推进
- 拿到文档后补
EdayunConstants的路径常量 - 按接口逐个补
dto/+adapter/XxxMapper+enums/(阶段 2 的 6 步) - 写只读探针 → 真机验证 → 全链路探针
- 补回调实现
- 更新本文档
已知的坑(从运去哪/信仓带来的经验)
| 坑 | 应对 |
|---|---|
文档参数名可能带 query. 前缀而实际不带 |
真机验证时必须核对 |
有些接口没有 code 只有 status |
信封校验要兼容两种 |
| 文档示例常是自动生成的占位符 | 不看示例值,看真机返回 |
| 单位可能未标注 | 真机验证量级(kg vs lb 差 2.2 倍) |
| 状态码可能依赖上下文(单据类型) | (type, status) 一起带出去 |