选择 SDK 还是 HTTP

TypeScript SDK 是当前事实源；HTTP 适合已有网关治理团队，但必须自己承担幂等、重试和错误分类。

选择 SDK

• 需要合规错误分类、polling、幂等 header 封装。
• 希望跟随 @acosmi/sdk-ts 的类型定义。
• 前端或 Node 服务已经使用 TypeScript。

选择 HTTP

• 你已有统一网关、审计和重试中间件。
• 需要把请求接入非 TS 运行时。
• 接口路径来自后端正式契约，而不是本文档推断。

当前 SDK 语言状态

TypeScript 是一等维护面；Go 为历史/暂停状态；Python 和 Java 没有在本次审计中发现一等 SDK 源。