Browse Source

feat(edayun): token 接口真机验证通过,按实际报文修正解析

真机调用(PR 环境):

  POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
  {"client_id":"openapi-test","client_secret":"123456"}
  → HTTP 200 {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}

文档与实际不符的两处,已按实测调整:

1. 响应是**扁平结构**,没有 code、没有 data 包裹。
   原来强制要求 code,会把成功当失败。改为:缺 code 不算失败,
   交给「有没有 access_token」判断;显式给了非 200 的 code 才判失败。

2. 响应**没有有效期字段**(文档说「永久,建议留窗口刷新」),也没有
   refresh_token。expiresAt 改为明确的估算值语义:让 TokenManager 定期
   重登一次,不是真的到期。

DTO 补了顶层 access_token / token_type / scope,data 保留为兼容分支。

探针 EdayunTokenProbeTest 实跑结果:token 取到(脱敏输出)、
tokenType=bearer、剩 7200 秒、refreshToken=null。

测试 13 个(新增 acceptsFlatShapeWithoutCode 固化实测形态;
missingCodeIsRejected 改为 missingCodeWithoutTokenIsRejected,
报「no access token」而不是「no code」)。

全量 535 个测试通过。

Co-Authored-By: Claude <noreply@anthropic.com>
master
chenchuchuan 1 week ago
parent
commit
5962988f86
  1. 28
      docs-warehouse/edayun/README.md
  2. 49
      warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/auth/EdayunTokenClient.java
  3. 36
      warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java
  4. 22
      warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java

28
docs-warehouse/edayun/README.md

@ -46,13 +46,29 @@
| `http/EdayunRequestFactory` | 构造 token 请求与业务请求;`sign()` 算 MD5 | | `http/EdayunRequestFactory` | 构造 token 请求与业务请求;`sign()` 算 MD5 |
| `adapter/EdayunAdapter.token(ctx)` | 走 `TokenManager` 缓存(按 `appKey + clientId` 维度) | | `adapter/EdayunAdapter.token(ctx)` | 走 `TokenManager` 缓存(按 `appKey + clientId` 维度) |
**三处待联调确认**: **真机验证(2026-11-12,PR 环境)**:
1. **响应体结构**——文档只给了 `code` 取值(200/500/503/504),**没给 body 字段**。 ```bash
现在兼容 `data.access_token` / `data.expiry` / 顶层 `token` 三种形态,真机确认后删多余分支。 POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
2. **token 有效期**——文档未写。`data.expires_in` 优先,其次 `data.expiry`, Content-Type: application/json
都没有按 2 小时兜底(`DEFAULT_TOKEN_TTL_SECONDS`)。 {"client_id":"openapi-test","client_secret":"123456"}
3. **是否有 refresh**——文档没提。当前按「过期重新登录」处理。
→ 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`)保留,生产确认后可删
## 待确认(问易达云) ## 待确认(问易达云)

49
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()}。 * / {@link common.ecommerce.shared.spi.ChannelSecret#clientSecret()}。
* appKey 不参与这一步(它是业务请求头的字段)。</p> * appKey 不参与这一步(它是业务请求头的字段)。</p>
* *
* <p><b>待联调确认</b>:文档只给了 {@code code} 的取值(200 / 500 / 503 / 504), * <p><b>实测(2026-11-12,PR 环境)</b>:成功响应的 body 是扁平结构,没有 {@code code}:</p>
* 没给响应体结构。所以这里同时兼容三种常见形态:</p> * <pre>
* <ul> * HTTP 200
* <li>{@code data.access_token} + {@code data.expires_in}(OAuth 标准)</li> * {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
* <li>{@code data.expiry}(绝对时刻)</li> * </pre>
* <li>{@code token} 直接放顶层</li> *
* </ul> * <p>token 是<b>永久</b>的(文档:「目前设计上是永久的,建议留个窗口刷新」),
* <p>都取不到时按 500 处理并带出原始报文(截断)。</p> * 响应里没有有效期字段。所以 {@code expiresAt} 是个估算值——用于让
* {@code TokenManager} 定期重登一次,而不是真的到期。</p>
*
* <p>兼容分支:若网关把结果包一层 {@code data} 或返回 {@code code},
* 也按对应形态解析(生产环境确认后可删)。</p>
*/ */
public final class EdayunTokenClient { public final class EdayunTokenClient {
@ -99,6 +103,10 @@ public final class EdayunTokenClient {
/** /**
* 业务码:200 成功;500 失败;503 网关无效;504 超时。 * 业务码:200 成功;500 失败;503 网关无效;504 超时。
* *
* <p><b>实测该接口不返回 {@code code}</b>——HTTP 200 + body 里有 access_token
* 就是成功。所以 {@code code} 缺失时不算失败,交给后续的 token 存在性校验;
* 只有显式给了非 200 的 code 才判失败。</p>
*
* <p>503 通常是网关问题、504 是超时,都值得重试;500 是明确失败,不重试。</p> * <p>503 通常是网关问题、504 是超时,都值得重试;500 是明确失败,不重试。</p>
*/ */
private void requireBusinessOk(EdayunTokenDtos.TokenResponse parsed, String body) { private void requireBusinessOk(EdayunTokenDtos.TokenResponse parsed, String body) {
@ -107,7 +115,8 @@ public final class EdayunTokenClient {
} }
Integer code = parsed.code; Integer code = parsed.code;
if (code == null) { if (code == null) {
throw validation("edayun token response has no code", body); // 实测:扁平结构没有 code,视为成功,由 tokenOf 校验 token 是否存在
return;
} }
if (code == EdayunConstants.CODE_SUCCESS) { if (code == EdayunConstants.CODE_SUCCESS) {
return; return;
@ -124,25 +133,34 @@ public final class EdayunTokenClient {
.build(); .build();
} }
/** 三种形态都试一遍;都取不到就失败,不猜。 */ /**
* 取 token:实测是顶层 {@code access_token};兼容 {@code data.access_token}
* 与顶层 {@code token}。都取不到就失败,不猜。
*/
private String tokenOf(EdayunTokenDtos.TokenResponse parsed, String body) { private String tokenOf(EdayunTokenDtos.TokenResponse parsed, String body) {
if (hasText(parsed.accessToken)) {
return parsed.accessToken.trim();
}
if (parsed.data != null && hasText(parsed.data.accessToken)) { if (parsed.data != null && hasText(parsed.data.accessToken)) {
return parsed.data.accessToken.trim(); return parsed.data.accessToken.trim();
} }
// 顶层 token(部分网关会把 data 拍平)
String topLevel = json.stringAt(body, "token"); String topLevel = json.stringAt(body, "token");
if (hasText(topLevel)) { if (hasText(topLevel)) {
return topLevel.trim(); return topLevel.trim();
} }
throw validation("edayun token response has no access token" 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);
} }
/** /**
* 过期时刻。 * 过期时刻(<b>估算</b>)。
*
* <p>实测响应<b>没有有效期字段</b>,文档也说 token「目前设计上是永久的,
* 建议留个窗口刷新」。所以这里返回一个估算值,作用只是让 {@code TokenManager}
* 定期重登一次,避免真出问题时卡死。</p>
* *
* <p>优先 {@code data.expires_in}(相对秒),其次 {@code data.expiry}(绝对), * <p>若将来响应里出现 {@code data.expires_in} 或 {@code data.expiry},
* 都没有就按 {@link EdayunConstants#DEFAULT_TOKEN_TTL_SECONDS} 兜底并标注待确认。</p> * 优先用真值。</p>
*/ */
private Instant expiresAtOf(EdayunTokenDtos.TokenResponse parsed) { private Instant expiresAtOf(EdayunTokenDtos.TokenResponse parsed) {
Instant now = Instant.now(clock); Instant now = Instant.now(clock);
@ -156,6 +174,7 @@ public final class EdayunTokenClient {
return absolute; return absolute;
} }
} }
// 文档:token 永久,建议定期刷新。按兜底周期重登一次。
return now.plusSeconds(EdayunConstants.DEFAULT_TOKEN_TTL_SECONDS); return now.plusSeconds(EdayunConstants.DEFAULT_TOKEN_TTL_SECONDS);
} }

36
warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java

@ -34,18 +34,42 @@ public final class EdayunTokenDtos {
/** /**
* 获取 token 响应。 * 获取 token 响应。
* *
* <p><b>待联调确认</b>:文档只给了 {@code code} 的取值约定 * <p><b>实测(2026-11-12,PR 环境)</b>:响应是<b>扁平结构</b>,没有 {@code code}
* (200 成功 / 500 失败 / 503 网关无效 / 504 超时),<b>没有给响应体结构</b>。 * 也没有 {@code data} 包裹:</p>
* 这里按常见形态预留了 {@code data.access_token} / {@code expires_in} / * <pre>
* {@code expiry},实际字段名以真机返回为准。</p> * {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
* </pre>
*
* <p>token 是<b>永久</b>的(文档原话「目前设计上是永久的,建议留个窗口刷新」),
* 响应里<b>没有有效期字段</b>,所以过期时刻只能按兜底值估算。</p>
*
* <p>{@code data} 保留为兼容分支:万一生产环境走了网关包装也能解析。</p>
*/ */
public static final class TokenResponse { public static final class TokenResponse {
/** 200 成功 / 500 失败 / 503 网关无效 / 504 超时。 */ /** 业务码;实测该接口不返回,仅在网关包装的场景出现。 */
public Integer code; public Integer code;
public String message; public String message;
/** 业务载荷;字段名待确认。 */ /** 实测的顶层字段:access token。 */
@JsonProperty("access_token")
public String accessToken;
/**
* 实测的顶层字段:{@code bearer}(小写)。
*
* <p>{@code AccessToken} 的默认值是 {@code Bearer}(首字母大写);业务请求里
* 易达云用的是独立的 {@code token} 头而不是 {@code Authorization} 头,
* 所以这个类型值目前不参与签名,原样保留即可。</p>
*/
@JsonProperty("token_type")
public String tokenType;
/** 实测的顶层字段:scope,如 {@code server}。 */
public String scope;
/** 刷新令牌;该接口不返回。 */
@JsonProperty("refresh_token")
public String refreshToken;
/** 兼容分支:网关把结果包一层 data 时使用。 */
public TokenData data; public TokenData data;
/** token 载荷。 */ /** token 载荷。 */

22
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 @Test
void acceptsOauthStandardShape() { void acceptsOauthStandardShape() {
RecordingTransport transport = RecordingTransport.create() RecordingTransport transport = RecordingTransport.create()
@ -133,12 +148,15 @@ class EdayunTokenClientTest {
} }
} }
/** 实测无 code;但 body 里也没有 token,所以要报「没有 access token」。 */
@Test @Test
void missingCodeIsRejected() { void missingCodeWithoutTokenIsRejected() {
RecordingTransport transport = RecordingTransport.create() RecordingTransport transport = RecordingTransport.create()
.route(EdayunConstants.PATH_TOKEN, req -> Responses.ok("{\"message\":\"ok\"}")); .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 @Test

Loading…
Cancel
Save