接口文档生成详细教程

77 阅读1分钟

接口文档是一个项目开发中必需的说明文档,但时接口文档编写起来比较费事费力。本文为大家推荐一款特别好用的接口文档生成工具--apipost

apipost是一款国产的接口测试和接口文档生成的工具。其中它接口文档生成的功能特别强大。

打开apipost编写一个登录的接口请求

![](https://pic1.zhimg.com/80/v2-ade57c5711a8d039cd68bfac294e5f24_720w.jpg)

它这里有两个功能,成功响应示例及文档和错误响应示例及文档

![](https://pic3.zhimg.com/80/v2-31652de37cdeb2e4d8fe63761fc81426_720w.jpg)

成功响应示例文档,我们点击从现有响应结果导入和导出字段,获得如图效果

![](https://pic1.zhimg.com/80/v2-d3e1d1d929abbeb665d7fed4c9b87708_720w.jpg)

分享文档查看

![](https://pic1.zhimg.com/80/v2-501cdf98f753b66bd399ce3a0aff2e80_720w.jpg)

还可以添加错误响应示例文档

![](https://pic1.zhimg.com/80/v2-7f2a0cf2a7153d0664608e215efb96c4_720w.jpg)

分享查看,成功和失败的响应示例都会出现

![](https://pic3.zhimg.com/80/v2-62ac33f968f0bed3b153b1086e593666_720w.jpg)

它还支持html、markdown和word格式的接口文档

![](https://pic3.zhimg.com/80/v2-6f7aebfb07f8df51bfad32cc2559d04e_720w.jpg)

看一下word格式的接口文档效果(word只生成成功响应示例文档)

![](https://pic1.zhimg.com/80/v2-d913ed597baedb845b2a5829e577587c_720w.jpg)

这就是apipost生成接口文档的具体流程了

工具下载地址:

ApiPost - 可直接生成文档的API调试、管理工具​www.apipost.cn图标