SuperAPI AI 工具集

api-sdk-generator

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:根据任意 REST API 生成生产质量的客户端库与 SDK 代码,涵盖客户端类、API 封装、请求/响应数据模型和各语言用法模式。

主要能力:按统一结构生成 sdk/ 目录,含主客户端类(base URL、鉴权、重试)、resources 下每个 API 资源一个文件、models 下请求/响应模型、errors 下的类型化错误类,以及 retry、pagination 工具。基础客户端示例中通过请求头携带 Authorization Bearer 令牌,对 429 状态码按 Retry-After 退避重试。资源类按 API 资源层级组织,提供 list/get/create/delete 等方法。错误类按状态码区分:401 鉴权错误、403 授权错误、404 未找到、422 校验错误、429 限流、5xx 服务端错误。分页辅助函数可遍历分页接口的所有页。

规则要求:始终包含对 429 和 5xx 的指数退避重试;始终包含标识 SDK 名称与版本的 User-Agent 头;所有模型必须类型化(Python 用 dataclass、TypeScript 用 interface、Go 用 struct);资源类需对应 API 资源层级;每个生成的类都应给出用法示例。

使用方式:在用户要求生成 API 客户端或 SDK 时调用。完成输出后,可提示用户是否要生成 API 测试用例(yes/no)。若回答 yes,则检查已安装技能列表中是否有 api-to-testcase-generator 技能,存在则按其说明以上述 API 作为输入执行;不存在则提示该技能未安装可安装后重跑。回答 no 则结束任务。

适用场景:需要快速为 REST API 搭建多语言客户端库、统一封装请求与模型、或生成带重试和分页能力的调用代码。

限制:资料未说明支持的完整语言列表、收费或价格信息;具体 API 的端点和模型字段需由用户提供。