如何把PostMan导出的json文件生成md或html的接口文档

1.下载docgen插件并改名

下载地址 : https://github.com/thedevsaddam/docgen

image-20220411163910178

下载完成后修改名字: docgen (D:\software\docgen 路径放在系统环境变量path下也行/不放也行 随个人)

image-20220411163958880

image-20220411164605406

2.执行获得生成的接口文档

(未添加进系统环境变量的)在当前目录下执行cmd 然后输入docgen

image-20220411165034615

生成接口文档指令

  • 要查看来自postman集合的实时 HTML 文档,请使用…这将打开postman集合的 html 版本到定义的端口

    docgen server -f json文件地址 -p 8000
    
  • 从postman集合查看实时 Markown 文档使用…这将打开邮递员集合的降价版本到定义的端口

    docgen server -f json文件地址 -p 8000 -m
    
  • 生成HTML 文档使用

    docgen build -i json文件地址 -o html文件地址和文件名
    
  • 生成Markdown 文档使用

    docgen build -i input-postman-collection.json -o md格式文件地址和文件名 -m
    

举例:

docgen server -f C:\Users\admin\Desktop\api\api.json -p 8000
docgen server -f C:\Users\admin\Desktop\api\api.json -p 8000 -m
docgen build -i C:\Users\admin\Desktop\api\api.json -o C:\Users\admin\Desktop\api\api.html
docgen build -i C:\Users\admin\Desktop\api\api.json -o C:\Users\admin\Desktop\api\api.md -m

猜你喜欢

转载自blog.csdn.net/m0_49969111/article/details/124116243