Changelog

December 5, 2025

3.23.0

(feat): 添加具有编译时安全分阶段构建器模式的 OAuth 令牌重写支持。当配置 oauth-token-override: true 时，SDK 用户可以在 OAuth 客户端凭据流或直接提供预生成的承载令牌之间选择。

配置示例：

1 config:
2   oauth-token-override: true

生成的使用方式：

1 // 选项 1：直接承载令牌（绕过 OAuth 流）
2 SeedApiClient client = SeedApiClient.withToken("my-pre-generated-bearer-token")
3     .url("https://api.example.com")
4     .build();
5 
6 // 选项 2：OAuth 客户端凭据流（自动令牌管理）
7 SeedApiClient client = SeedApiClient.withCredentials("your-client-id", "your-client-secret")
8     .url("https://api.example.com")
9     .build();

3.22.0

(feat): 添加对推断认证方案的支持。推断认证允许 SDK 使用 scheme: bearer 和 get-token 配置从自定义（非 OAuth）令牌端点自动获取令牌。生成的 InferredAuthTokenSupplier 类处理令牌缓存和在过期前 2 分钟缓冲时间的自动刷新。

配置示例：

1 auth:
2   scheme: bearer
3   get-token:
4     endpoint: POST auth.retrieveToken

生成的使用方式：

1 SeedApiClient client = SeedApiClient.builder()
2     .apiKey("your-api-key")
3     .build();
4 // 令牌会根据需要自动获取和刷新

1	// 选项 1：直接承载令牌（绕过 OAuth 流）
2	SeedApiClient client = SeedApiClient.withToken("my-pre-generated-bearer-token")
3	.url("https://api.example.com")
4	.build();
5
6	// 选项 2：OAuth 客户端凭据流（自动令牌管理）
7	SeedApiClient client = SeedApiClient.withCredentials("your-client-id", "your-client-secret")
8	.url("https://api.example.com")
9	.build();

1	auth:
2	scheme: bearer
3	get-token:
4	endpoint: POST auth.retrieveToken

1	SeedApiClient client = SeedApiClient.builder()
2	.apiKey("your-api-key")
3	.build();
4	// 令牌会根据需要自动获取和刷新