Node.js下使用API Blueprint格式写API文档的工作环境
API Blueprint使用md文档的格式,快速书写API文档,并且可以通过文档生成便于查看的HTML文档(使用aglio),也可以生成测试用的Mock服务器(使用Drakov)。
文档书写格式,请查看API Blueprint。一些文档书写例子,请查看https://github.com/apiaryio/api-blueprint/tree/master/examples
需要Node.js环境
$ git clone https://github.com/ihahoo/node-apiblueprint.git
$ npm install
通过src/index.md
来写文档,运行下面的命令,可以以网页形式时时查看文档。
$ npm run doc
然后通过浏览器打开http://localhost:3000/
即可查看文档,修改文档的同时可以自动刷新显示。
可以按照API Blueprint的文档格式,自动生成测试api的数据。这样描述好API文档后,前端即可进行一些调用测试。 执行以下命令:
$ npm run mock
然后通过http://localhost:3001/
测试接口,在本例子中,可以通过GET http://localhost:3001/test 查看测试的接口样例。
$ npm run build
通过此命令,可将文档转换为html并保存到build
目录下,即可将文档提交给其它开发人员查阅。
$ npm run clean