哈喽我是 Raina~ 平时大家在进行接口测试的时候,需要对着冗长的接口文档,一个个复制接口地址、请求方法、参数,手动在Postman里创建一条条接口用例,进行断言设置、造数据等操作,耗时又容易出错,尤其是接口数量多的时候,光是录入就要花大半天。

为了解决这个问题,我生成了一个Skill——根据接口文档快速生成可导入Postman的JSON脚本,核心作用是根据接口文档,自动提取接口信息(URL、请求方式、请求头、参数、响应格式)并批量生成规范的接口用例,直接导出可一键导入 Postman 的 JSON 脚本,把「文档→用例→可执行脚本」的流程一次性跑完。

它能解决哪些问题?

  • 解决手动录入繁琐的问题:无需逐行复制接口地址、请求参数、请求头,省去大量的重复操作。
  • 解决录入出错的问题:手动复制容易漏填参数、输错地址,AI自动解析接口文档,生成的JSON精准对应,减少人为失误;
  • 降低工具使用门槛:导入JSON就能直接生成接口项目,无需再学习复杂的接口创建流程;

前置准备

  1. 准备好完整的接口文档(建议为.md格式,清晰包含接口名称、请求方法、URL、参数、请求头、响应示例等信息,越完整,生成的脚本越精准);

  2. Cursor等AI工具

  3. 准备Skill安装包

可以自己去生成一个,如果想要现成的,也可以进【Raina的AI&测试学习圈】获取,里面还有很多AI赋能测试的skills及相关落地教程。

实操步骤

使用Skill,生成Postman JSON文件

1、接口文档准备

首先,将你整理好的接口文档(比如Markdown格式等),上传到Cursor的当前项目中,确保文档内容可正常识别

2、对话大模型,生成JSON

打开Cursor的对话窗口,输入指令:“skill+接口文档”,然后发送指令,等待AI解析接口文档。

解析完成后,AI会直接输出一份完整的 JSON文件

导入Postman/Apipost,开始测试

1、打开接口工具apipost,点击左上角「新建」,在下拉菜单中选择「导入项目」;

2、在弹出的导入窗口中,「数据来源」选择「Postman」,然后点击「上传文件」,找到刚才保存的.json文件,选中后上传;

3、导入完成后,点击左侧「API管理」,就能看到所有从接口文档中解析出来的接口,无需手动添加;

4、最后,根据自己的测试需求,配置全局URL、请求头(比如Token、Content-Type)等信息,就能直接发起接口测试啦~

学习建议

  1. 接口文档尽量规范:虽然AI能识别多种格式的文档,但规范的接口文档(明确标注接口地址、请求方法、参数类型、必填项),能让生成的JSON更精准,减少后续修改的麻烦;
  2. 导入后核对关键信息:生成JSON并导入工具后,建议先核对几个核心接口的地址、参数,确认无误后再进行测试,避免因文档识别偏差导致测试失败;
  3. 灵活适配工具:不管是Postman还是ApiPost,导入逻辑一致,大家可以根据自己平时的使用习惯选择工具,无需额外学习新工具的操作;
  4. 多尝试多优化:如果遇到接口识别不完整的情况,可以在Cursor对话中补充指令(比如“补充缺失的接口参数”),AI会重新解析,逐步优化生成结果。
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐