create Client
fun createClient(config: SdkConfig, accessToken: String? = null, requestIdGenerator: () -> String = { generateRequestId() }): <Error class: unknown class>
创建配置好的 HTTP 客户端 配置包括:JSON 序列化、日志、默认请求头、响应验证、超时、重试等
认证头自动选择逻辑:
当 config.apiKey 存在时,使用
X-Api-Keyheader(Client 认证)当仅有 accessToken 时,使用
Authorization: Bearerheader(OAuth/Client 认证)两者都存在时,优先使用
X-Api-Key(服务端行为)
认证方式说明:
Client 认证:使用
X-Api-Key,适用于签名交换/换新场景(参考认证方式与服务器端点.md)OAuth 认证:使用
Authorization: Bearer,适用于用户授权场景(参考基础接口/签名交换.md)
Return
配置好的 HttpClient 实例
Parameters
config
SDK 配置对象,包含 apiKey 等配置
access Token
可选的访问令牌,当 config.apiKey 为空时使用
request Id Generator
请求 ID 生成器,默认为随机生成