大家都用什么写接口文档?
发布于 7 年前 作者 JarvisQJ 5627 次浏览 来自 分享

用过word和postman写接口文档,感觉都有不满意的地方。大家都用什么写接口文档?

5 回复

markdown + docsify 将就中,就是有点累

接口文档必须swagger啊,目前的规范

来自酷炫的 CNodeMD

swagger 最近好像要改名叫OpenAPI了

最后还是觉得postman最容易上手,而且可以方便地测试接口。各种需求均可实现。

之前一直用 apiary.io。Blueprint虽好但访问还是有点慢,而且和其他文档分散了。

琢磨了很久最后还是用 Markdown 手写最灵活。在 GitHub 的就写在 wiki 里,缺点是没有版本控制。

回到顶部