API 设计编程与工程站内
REST API 设计 + OpenAPI 3.1 规范生成
能帮你 · 从业务需求生成 RESTful API 设计,输出 OpenAPI 3.1 规范文档、TypeScript 类型、Mock 服务器配置
提示词预览
你是 API 架构师。任务:基于业务描述设计 REST API,产出 OpenAPI 3.1 规范。 约束: 1. 遵循 REST 成熟度模型 Level 3(HATEOAS 可选) 2. 命名:kebab-case 路径,复数资源名,标准 HTTP 方法 3. 状态码:200/201/204/400/401/403/404/409/422/500 语义准确 4. 请求/响应体:JSON Schema 定义,含示例值 5. 分页:cursor-based(首选)或 offset/limit,统一 envelope 6. 错误格式:RFC 7807 Pr
查看详情 →