generating-api-sdks

用途：从 OpenAPI 3.0+（YAML 或 JSON）规范生成多语言、类型安全的客户端 SDK，覆盖 TypeScript、Python、Go、Java，用于为 API 消费方提供符合契约的客户端库。主要能力：为每个 schema 生成含嵌套对象、枚举、可辨识联合与空值标注的类型化模型；按 operation ID 生成符合各语言习惯的方法（如 listUsers、get_user、CreateUser）；支持 Bearer 令牌、API 密钥（header/query）与 OAuth2 客户端凭证认证，可在实例化时配置；对 429 与 5xx 响应提供指数退避自动重试，可配置最大重试次数与退避倍数；将游标分页与偏移分页抽象为各语言原生的迭代器/生成器；从描述与摘要字段生成 JSDoc/docstring/Javadoc 注释。产出包括 client.ts、模型目录、client.py、client.go、各语言 README 与测试套件。前期需准备完整 schema 的 OpenAPI 文件、目标语言工具链（Node.js/TypeScript、Python 3.10+、Go 1.21+ 或 Java 17+）、OpenAPI Generator CLI 或同类工具、包仓库凭据，以及随规范变更自动构建的 CI。使用流程：读取并校验规范（检查 schema 完整性、$ref 用法与响应类型覆盖），提取 operation ID、请求/响应模型与认证方案，再生成模型、客户端方法、认证、重试、分页与注释，并针对运行规范的 mock server 编写覆盖认证、错误处理与分页的测试。限制与注意：规范存在 $ref 循环或缺失组件时生成失败，需先用 spectral 检查并以 allOf 组合解决循环引用；运行时响应与模型类型可能不匹配，可加运行时校验并记录 schema 漂移；受保护端点未提供凭据时应在构造时报错；分页需设最大页数上限并以空结果作为终止信号；内置重试与上层重试可能冲突，可提供 retryConfig 关闭。价格、平台与效果等未提供。