解救开发人员写文档的痛苦

开发人员的痛苦

接手前人的项目，没有接口文档，只能看代码学习

接口文档用txt、word、markdown写，编写特别麻烦，写出来的文档也不美观。

多层级的参数（子参数），写起来麻烦，不知道怎么表达更好。

有的文档须要图文并茂，须要代码示例，须要测试用例，须要提供mock ...

经常使用参数须要重复写不少次，没有快速的引用的功能

写完接口，还须要本身写代码测试接口是否正确

前端须要等待服务端把接口写完后，才能进行联调开发

解决方案

使用专业的接口管理工具：易文档，集合API文档管理，接口在线测试，一键生成mock配置，测试用例

支持http、tcp、markdown、富文本多种文档格式

专门为http文档准备的编辑器，编写方便快速，不须要动鼠标，写完一个 tab 一下就下一个，全键盘操做

支持经常使用参数快捷引用，再也不作无聊的重复工做；

支持预约义域名，快速切换测试服，正式服。

支持参数行顺序调整，拖动就能调整

能够随意增长 /删除参数块，好比我不须要头部参数，我能够删除；我能够添加成功时返回什么参数，失败时又返回什么参数

能够自定义说明，好比我想在请求参数后面添加一个特别说明，或者示例，我能够随时增减，而且随时调整顺序

能够在线测试接口，测试完还能够把调用结果保存为测试用例，方便他人查看和快速引用

漂亮专业的预览页，点击就能自动复制 url，参数名等

文档列表能够进行分类，调整顺序，搜索

能够随时分享文档给朋友，能够设置密码、失效时间