CodeBuddy可解析Swagger/OpenAPI文档自动生成Mock数据:上传文档后校验合法性,配置接口生成策略(基础/批量/随机化),支持复制JSON或启动本地Mock Server(如http://localhost:3005)供前端调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果你正在前后端联调阶段,后端接口尚未就绪但已有swagger.json或openapi.yaml文档,CodeBuddy能直接解析该文件生成结构准确、字段合规的Mock响应数据,避免手动编写JSON样本或硬编码假值。
上传并解析Swagger文档
在CodeBuddy左侧导航栏点击「Mock中心」→「新建Mock项目」→ 选择「从API文档导入」。
点击「上传文件」按钮,选择本地的swagger.json或openapi.yaml;【必须确保文档中包含完整的paths和components.schemas定义,否则响应体字段可能缺失或类型推断错误】。
文档上传后,CodeBuddy自动校验语法合法性。若出现“Schema未定义”警告,说明部分响应引用了未声明的$ref,需检查文档是否完整导出(例如是否遗漏definitions节)。
配置目标接口与生成策略
文档加载成功后,右侧显示所有已识别的接口路径列表。展开任一路径(如/api/users),勾选对应HTTP方法(GET/POST等)。
点击该接口右侧的「生成Mock」按钮,在弹窗中选择生成模式:
方法一:基础生成——直接输出单条符合响应schema的JSON对象,字段值按类型填充默认示例(string→"example",number→42,boolean→true)。
CodeBuddy IDE
CodeBuddy IDE 是一款全流程 AI 智能编程工具,主打“对话即编程”。它深度融合产品、设计与研发,支持自然语言生成需求文档、Figma 设计稿一键转代码、智能补全及一键云端部署。集成腾讯混元、DeepSeek 等主流大模型,覆盖百种编程语言,助力零基础用户至专业开发者高效实现从构想到上线的一站式交付。
下载
方法二:批量生成——输入数量(如10),生成含items数组的响应,适用于列表接口。
方法三:启用随机化——勾选后,name字段将从中文姓名库随机选取,email使用真实域名格式,id生成6位随机整数,避免前端缓存导致的渲染异常。
导出与接入本地开发环境
第一步:点击「复制JSON」,将生成结果粘贴至前端代码中的mock配置对象,或保存为mock-data.json供json-server加载。
第二步:若需实时HTTP服务,点击「启动本地Mock Server」,CodeBuddy自动分配端口(如http://localhost:3005),所有接口路径与原始文档完全一致,例如访问GET http://localhost:3005/api/users即返回刚生成的数据。
第三步:确认前端请求地址已切换为该本地地址,并关闭CORS代理——【此时若仍请求旧域名,浏览器控制台会报跨域错误,务必检查axios或fetch的baseURL配置】。