createClient

fun createClient(config: SdkConfig, accessToken: String? = null, requestIdGenerator: () -> String = { generateRequestId() }): <Error class: unknown class>

创建配置好的 HTTP 客户端 配置包括:JSON 序列化、日志、默认请求头、响应验证、超时、重试等

认证头自动选择逻辑:

  • 当 config.apiKey 存在时,使用 X-Api-Key header(Client 认证)

  • 当仅有 accessToken 时,使用 Authorization: Bearer header(OAuth/Client 认证)

  • 两者都存在时,优先使用 X-Api-Key(服务端行为)

认证方式说明:

  • Client 认证:使用 X-Api-Key,适用于签名交换/换新场景(参考 认证方式与服务器端点.md

  • OAuth 认证:使用 Authorization: Bearer,适用于用户授权场景(参考 基础接口/签名交换.md

Return

配置好的 HttpClient 实例

Parameters

config

SDK 配置对象,包含 apiKey 等配置

accessToken

可选的访问令牌,当 config.apiKey 为空时使用

requestIdGenerator

请求 ID 生成器,默认为随机生成