当前一等事实源是 @acosmi/sdk-ts。Go / Python / Java / OpenAPI 不再被写成同等已发布能力；contract_template scope 的后端 OAuth 对齐作为已知缺口呈现。
API key、OAuth、JWT 三种认证方式选哪个。
用 cURL 调通最简单的接口。
什么时候用 SDK，什么时候直接打 HTTP。
签名验证 + 重试策略 + 幂等。
API key / OAuth / JWT 的适用场景。
标准错误对象、HTTP 状态映射、可重试码。
桶模型、Retry-After、企业配额。
SSE 与 WebSocket 怎么选。
用 Idempotency-Key 安全重试。
签名、重试、回调最佳实践。
前端 SDK + 后端代理 + Token 计量。
用 cron + Webhook 跑周期性任务。
知识库 → 向量 → 检索 → 智能体。
