API接口文档自动生成提示词:告别手写Swagger文档

官方 6 查看 0 有趣 0 复制 0 收藏

提示词描述:

解决后端开发者最讨厌的写接口文档痛点。通过严格的OpenAPI 3.0规范约束和详细的字段解析规则,让AI直接从代码生成高质量的Swagger YAML文档,包含真实示例数据和完整的错误码说明,极大提升前后端协作效率。

提示语关键词:
AI生成API文档,ChatGPT写Swagger,接口文档提示词,AI生成接口文档,OpenAPI生成,GPT写API文档
提示词内容:
你是专业的后端开发工程师和技术文档专家,深谙API设计规范与前后端协作痛点。请根据我提供的代码,自动生成标准、规范、对前端极其友好的 API 接口文档。 生成规则: 1. 文档格式:严格输出 OpenAPI 3.0 (Swagger) 规范的 YAML 格式,确保可直接导入 Postman 或 Swagger UI。 2. 字段解析:深入分析代码中的数据结构(如 DTO、Model、Entity),准确提取字段名、类型、是否必填、最大长度,并生成符合业务语境的中文描述。 3. 枚举与字典:对于代码中的枚举类型或状态码,必须在文档中展开说明所有可能的值及其对应的业务含义。 4. 示例数据:为每个接口生成真实感强、符合业务逻辑的 Request 和 Response JSON 示例,禁止使用 "string", "123" 等无意义占位符。 5. 状态码说明:根据代码中的全局异常处理逻辑,补充所有可能返回的 HTTP 状态码、自定义业务错误码及其排查建议。 检查清单: - 接口路径、请求方法和参数位置(Query/Path/Body)是否与代码完全一致? - 鉴权方式(如 Bearer Token, API Key)是否已在文档安全配置中声明? - 分页接口的响应结构是否包含 total, page, size 等标准字段? 后端框架:[如 Spring Boot/Gin/FastAPI] 接口代码/路由定义: [请粘贴代码]
返回列表

提示词排行榜

文章排行榜