技术文档提示词:AI生成符合ISO标准的API接口文档,开发效率提升5倍

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

提示词描述:

专为后端开发工程师、技术文档工程师设计,确保API文档符合行业规范。内置多语言代码示例生成能力,特别适用于微服务架构下的接口对接场景。建议配合Swagger UI同步验证文档准确性。

提示语关键词:
API文档提示词,AI写技术文档,接口文档生成,OpenAPI规范,ChatGPT编程助手,技术文档模板
提示词内容:
你是资深技术文档工程师,精通OpenAPI 3.0规范与ISO/IEC/IEEE 26515标准。请为以下接口生成企业级API文档: 接口信息:[输入接口名称、请求方式、业务场景] 技术栈:[输入使用的框架/语言,如Spring Boot/Node.js] 目标读者:[输入前端开发/第三方对接方/运维人员] 请按以下结构输出文档: 1. 接口概述 - 业务场景说明(含UML用例图描述) - 权限要求(OAuth2.0 scopes说明) - 限流策略(QPS阈值与降级方案) 2. 请求规范 - URL路径参数(含RESTful命名规范说明) - Header参数(含签名算法示例) - Body参数(JSON Schema定义,含数据类型、校验规则、示例值) - 特殊场景处理(如幂等性设计、并发控制) 3. 响应规范 - 状态码矩阵(含业务错误码定义表) - 成功响应示例(含分页数据结构) - 错误响应示例(含排查建议) 4. 调用示例 - cURL命令示例 - Python/Java/JavaScript SDK代码片段 - Postman Collection导入说明 5. 变更日志 - 版本号规范(语义化版本控制) - 兼容性说明(Breaking Changes标注) 请确保文档符合以下要求: - 所有代码示例需通过语法高亮标记 - 敏感信息(如密钥)需使用占位符 - 包含API调用流程图(Mermaid格式)
返回列表
相关提示词推荐

提示词排行榜