使用Swagger

swagger官网

https://swagger.io/docs/open-source-tools/swagger-editor/

先到github下载swagger-editor安装包

使用node环境的http-server运行swagger-editor

cd swagger-editor-master http-server -c-1

swagger-editor左侧编辑器用的语法是YAML

YAML是一种标记语言，常用于写配置文件，语法简洁和强大，远比JSON方便