diff --git a/docs-warehouse/edayun/README.md b/docs-warehouse/edayun/README.md index 6eee6a4..d07ec9d 100644 --- a/docs-warehouse/edayun/README.md +++ b/docs-warehouse/edayun/README.md @@ -46,13 +46,29 @@ | `http/EdayunRequestFactory` | 构造 token 请求与业务请求;`sign()` 算 MD5 | | `adapter/EdayunAdapter.token(ctx)` | 走 `TokenManager` 缓存(按 `appKey + clientId` 维度) | -**三处待联调确认**: +**真机验证(2026-11-12,PR 环境)**: -1. **响应体结构**——文档只给了 `code` 取值(200/500/503/504),**没给 body 字段**。 - 现在兼容 `data.access_token` / `data.expiry` / 顶层 `token` 三种形态,真机确认后删多余分支。 -2. **token 有效期**——文档未写。`data.expires_in` 优先,其次 `data.expiry`, - 都没有按 2 小时兜底(`DEFAULT_TOKEN_TTL_SECONDS`)。 -3. **是否有 refresh**——文档没提。当前按「过期重新登录」处理。 +```bash +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`)保留,生产确认后可删 ## 待确认(问易达云) diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/auth/EdayunTokenClient.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/auth/EdayunTokenClient.java index 181a1f6..1c4bc33 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/auth/EdayunTokenClient.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/auth/EdayunTokenClient.java @@ -21,14 +21,18 @@ import java.time.Instant; * / {@link common.ecommerce.shared.spi.ChannelSecret#clientSecret()}。 * appKey 不参与这一步(它是业务请求头的字段)。
* - *待联调确认:文档只给了 {@code code} 的取值(200 / 500 / 503 / 504), - * 没给响应体结构。所以这里同时兼容三种常见形态:
- *都取不到时按 500 处理并带出原始报文(截断)。
+ *实测(2026-11-12,PR 环境):成功响应的 body 是扁平结构,没有 {@code code}:
+ *
+ * HTTP 200
+ * {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
+ *
+ *
+ * token 是永久的(文档:「目前设计上是永久的,建议留个窗口刷新」), + * 响应里没有有效期字段。所以 {@code expiresAt} 是个估算值——用于让 + * {@code TokenManager} 定期重登一次,而不是真的到期。
+ * + *兼容分支:若网关把结果包一层 {@code data} 或返回 {@code code}, + * 也按对应形态解析(生产环境确认后可删)。
*/ public final class EdayunTokenClient { @@ -99,6 +103,10 @@ public final class EdayunTokenClient { /** * 业务码:200 成功;500 失败;503 网关无效;504 超时。 * + *实测该接口不返回 {@code code}——HTTP 200 + body 里有 access_token + * 就是成功。所以 {@code code} 缺失时不算失败,交给后续的 token 存在性校验; + * 只有显式给了非 200 的 code 才判失败。
+ * *503 通常是网关问题、504 是超时,都值得重试;500 是明确失败,不重试。
*/ private void requireBusinessOk(EdayunTokenDtos.TokenResponse parsed, String body) { @@ -107,7 +115,8 @@ public final class EdayunTokenClient { } Integer code = parsed.code; if (code == null) { - throw validation("edayun token response has no code", body); + // 实测:扁平结构没有 code,视为成功,由 tokenOf 校验 token 是否存在 + return; } if (code == EdayunConstants.CODE_SUCCESS) { return; @@ -124,25 +133,34 @@ public final class EdayunTokenClient { .build(); } - /** 三种形态都试一遍;都取不到就失败,不猜。 */ + /** + * 取 token:实测是顶层 {@code access_token};兼容 {@code data.access_token} + * 与顶层 {@code token}。都取不到就失败,不猜。 + */ private String tokenOf(EdayunTokenDtos.TokenResponse parsed, String body) { + if (hasText(parsed.accessToken)) { + return parsed.accessToken.trim(); + } if (parsed.data != null && hasText(parsed.data.accessToken)) { return parsed.data.accessToken.trim(); } - // 顶层 token(部分网关会把 data 拍平) String topLevel = json.stringAt(body, "token"); if (hasText(topLevel)) { return topLevel.trim(); } throw validation("edayun token response has no access token" - + " (looked for data.access_token and token)", body); + + " (looked for access_token, data.access_token and token)", body); } /** - * 过期时刻。 + * 过期时刻(估算)。 + * + *实测响应没有有效期字段,文档也说 token「目前设计上是永久的, + * 建议留个窗口刷新」。所以这里返回一个估算值,作用只是让 {@code TokenManager} + * 定期重登一次,避免真出问题时卡死。
* - *优先 {@code data.expires_in}(相对秒),其次 {@code data.expiry}(绝对), - * 都没有就按 {@link EdayunConstants#DEFAULT_TOKEN_TTL_SECONDS} 兜底并标注待确认。
+ *若将来响应里出现 {@code data.expires_in} 或 {@code data.expiry}, + * 优先用真值。
*/ private Instant expiresAtOf(EdayunTokenDtos.TokenResponse parsed) { Instant now = Instant.now(clock); @@ -156,6 +174,7 @@ public final class EdayunTokenClient { return absolute; } } + // 文档:token 永久,建议定期刷新。按兜底周期重登一次。 return now.plusSeconds(EdayunConstants.DEFAULT_TOKEN_TTL_SECONDS); } diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java index 5259d3a..de9f590 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java @@ -34,18 +34,42 @@ public final class EdayunTokenDtos { /** * 获取 token 响应。 * - *待联调确认:文档只给了 {@code code} 的取值约定 - * (200 成功 / 500 失败 / 503 网关无效 / 504 超时),没有给响应体结构。 - * 这里按常见形态预留了 {@code data.access_token} / {@code expires_in} / - * {@code expiry},实际字段名以真机返回为准。
+ *实测(2026-11-12,PR 环境):响应是扁平结构,没有 {@code code} + * 也没有 {@code data} 包裹:
+ *
+ * {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
+ *
+ *
+ * token 是永久的(文档原话「目前设计上是永久的,建议留个窗口刷新」), + * 响应里没有有效期字段,所以过期时刻只能按兜底值估算。
+ * + *{@code data} 保留为兼容分支:万一生产环境走了网关包装也能解析。
*/ public static final class TokenResponse { - /** 200 成功 / 500 失败 / 503 网关无效 / 504 超时。 */ + /** 业务码;实测该接口不返回,仅在网关包装的场景出现。 */ public Integer code; public String message; - /** 业务载荷;字段名待确认。 */ + /** 实测的顶层字段:access token。 */ + @JsonProperty("access_token") + public String accessToken; + /** + * 实测的顶层字段:{@code bearer}(小写)。 + * + *{@code AccessToken} 的默认值是 {@code Bearer}(首字母大写);业务请求里 + * 易达云用的是独立的 {@code token} 头而不是 {@code Authorization} 头, + * 所以这个类型值目前不参与签名,原样保留即可。
+ */ + @JsonProperty("token_type") + public String tokenType; + /** 实测的顶层字段:scope,如 {@code server}。 */ + public String scope; + /** 刷新令牌;该接口不返回。 */ + @JsonProperty("refresh_token") + public String refreshToken; + + /** 兼容分支:网关把结果包一层 data 时使用。 */ public TokenData data; /** token 载荷。 */ diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java index a51e107..19a76c1 100644 --- a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java +++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java @@ -56,6 +56,21 @@ class EdayunTokenClientTest { // ------------------------------------------------------------ 响应形态 + /** 实测形态:HTTP 200 + 扁平 body,没有 code。 */ + @Test + void acceptsFlatShapeWithoutCode() { + RecordingTransport transport = RecordingTransport.create() + .route(EdayunConstants.PATH_TOKEN, req -> Responses.ok( + "{\"access_token\":\"0dabff46-0492-44bc-9283-64163dc8a995\"," + + "\"token_type\":\"bearer\",\"scope\":\"server\"}")); + + AccessToken token = client(transport).fetch(BASE, "openapi-test", "123456"); + + assertEquals("0dabff46-0492-44bc-9283-64163dc8a995", token.value()); + // 响应无有效期字段,按兜底周期估算 + assertEquals(Instant.parse("2026-11-12T02:00:00Z"), token.expiresAt()); + } + @Test void acceptsOauthStandardShape() { RecordingTransport transport = RecordingTransport.create() @@ -133,12 +148,15 @@ class EdayunTokenClientTest { } } + /** 实测无 code;但 body 里也没有 token,所以要报「没有 access token」。 */ @Test - void missingCodeIsRejected() { + void missingCodeWithoutTokenIsRejected() { RecordingTransport transport = RecordingTransport.create() .route(EdayunConstants.PATH_TOKEN, req -> Responses.ok("{\"message\":\"ok\"}")); - assertThrows(ValidationException.class, () -> client(transport).fetch(BASE, "u", "p")); + ValidationException ex = assertThrows(ValidationException.class, + () -> client(transport).fetch(BASE, "u", "p")); + assertTrue(ex.getMessage().contains("no access token"), ex.getMessage()); } @Test