大家都用什么写接口文档？
发布于 8 年前 作者 JarvisQJ 6664 次预览 最后一次回复是 8 年前 来自 分享
用过word和postman写接口文档，感觉都有不满意的地方。大家都用什么写接口文档？
5 回复
作者
作者其他话题
- 请教一个关于js执行栈的问题
- 求教一个Redis有序集合score排序问题
- 求助：如何获取请求数据中的二进制文件？
- let a=1;function foo (){console.log('a:',a);let a = 2;};foo();为什么报错？
- 《JavaScript高级程序设计》中的一个疑点
- 如何在电子合同模板中写入动态数据？
- 在并发情况下，node程序莫名卡住，不报错，之后所有请求都是无法响应
- 一个请求的res.header被写入另一个请求的消息头！！？？
- 使用alinode，锁定了我的Nodejs版本到10？
- 架构层面高并发解决方案选择----项目架构模式选择
- IPC与AMQP是什么关系
- 基于Egg，搭建支持高并发系统
- 请教一条mongodb查询语句
- 请教如何设计有各种统计需求的数据库？
- 为delete请求如何传参和前端开撕，我该怎么办？
markdown + docsify 将就中，就是有点累
接口文档必须swagger啊，目前的规范
来自酷炫的 CNodeMD
swagger 最近好像要改名叫OpenAPI了
最后还是觉得postman最容易上手，而且可以方便地测试接口。各种需求均可实现。
之前一直用 apiary.io。Blueprint虽好但访问还是有点慢，而且和其他文档分散了。
琢磨了很久最后还是用 Markdown 手写最灵活。在 GitHub 的就写在 wiki 里，缺点是没有版本控制。