使用apipost工具快速生成在线接口文档

ApiPost是一个支持团队协作,并可直接生成文档的API调试、管理工具。它支持模拟POST、GET、PUT等常见请求,是后台接口开发者或前端、接口测试人员不可多得的工具 。使用者不仅可以利用apiopst调试接口,还可以书写相关注释(接口文档),方便的生成可读性好、界面美观的在线接口文档。

本文主要包含以下内容:

介绍ApiPost工具,它能做什么

下载、安装的方法

一些常用的操作

介绍一些使用技巧

前言:apipost能做什么?

ApiPost是一个支持团队协作,并可直接生成文档的API调试、管理工具。它可以像postman那样支持模拟POST、GET、PUT等常见请求也可以快速生成接口文档,是后台接口开发者或前端、接口测试人员不可多得的工具 。首先看下它的界面风格。

使用apipost工具快速生成在线接口文档

下载、安装apipost

ApiPost安装下载十分简单,在官网(自行百度)直接下载对应操作系统的安装包(支持window、mac、linux)安装即可,官网也提供了丰富的安装文档,这里不再赘述了。

一些常用的操作

ApiPost支持常见的接口发送、文档生成等。作为一名开发者,相信你从上面截图就可以基本看出来它的使用方法。这里主要介绍一些其他的常见操作。不过初次使用的时候,需要先注册一个账号,创建一个项目,然后点击左侧的 APIS 菜单栏就进到控制台了。

以下图是针对目录的常用操作

使用apipost工具快速生成在线接口文档

总之使用基本很简单,你下载安装一看就会了,实在有问题可以去官网查看文档或者去社区提问。

一些操作技巧

小技巧之:快速导入参数

apipost支持多种格式的参数导入,见下图,你再也不用一个一个参数的慢慢写了:

使用apipost工具快速生成在线接口文档

导入格式支持key-value和json格式:

使用apipost工具快速生成在线接口文档

1-1:key-value格式导入示例:

key-value格式常见的就是浏览器(F12)控制台的数据格式,见下图:

使用apipost工具快速生成在线接口文档

我们,复制以上请求头参数,然后粘贴到apipost,点击导入

使用apipost工具快速生成在线接口文档

参数则瞬间导入到了请求参数中,见下图:

使用apipost工具快速生成在线接口文档

以上示例只是展示了如何快速导入到header参数,其他参数比如query、body操作方式是一模一样滴。

1-2:json格式导入示例:

apipost也支持json格式的参数导入,参数格式可以如下:

{
    "id": 123,
    "title": "我是标题"
}
使用apipost工具快速生成在线接口文档

如图,点击导入,参数也快速导入到了请求参数中。

使用apipost工具快速生成在线接口文档

小技巧之:参数注释自动识别

上面我们写了如何快速导入参数,其实对于生成接口文档来说,参数描述(注释)才是最要命的,对于我们一直忙碌的程序员,花大量时间用在写文档上实在太累!

好在apipost帮我们节省了很多时间,一个参数,只要写过一次注释,下次遇到同样的参数直接选中就行。举例:

使用apipost工具快速生成在线接口文档

在上图中,我们针对id和title写了对应的注释:

id:“我是文章Id”

title:“我是文章标题”

当我们新建一个接口的时候,假如这个接口同样用到了 id或者title等参数,点击参数描述就会呈现出刚刚输入过的参数描述,直接选中即可,不用再麻烦的打字输入了。

使用apipost工具快速生成在线接口文档

这个小功能是不是节约了开发小伙伴很多时间呢?

小技巧之:快速定位当前接口目录

左侧的目录默认都是闭合的,有时候我们不知道当前正在编辑的接口属于哪个目录,找起来相当头疼。apipost提供了“定位到当前接口目录” 功能(见下图),可以快速打开当前正在编辑的接口、文档所在的目录,是不是解决了您的大问题了呢?

使用apipost工具快速生成在线接口文档

其实,apipost还有很多很多更加符合中国人操作习惯的小功能,等待您去发现。

小技巧之:生成并分享在线接口文档

说了这么多,好像还没说到重点,apipost怎么生成接口文档呢?很简单:新版ApiPost支持分享单个项目、也支持分享单个目录或者文档:

使用apipost工具快速生成在线接口文档

支持设置文档链接的有效期:

使用apipost工具快速生成在线接口文档

支持设置文档的查看权限:

使用apipost工具快速生成在线接口文档

小TIPS:apipost 导出文档响应为空?

很多小伙伴问,为什么apipost 导出文档响应为空?那是因为你么有添加响应示例。

ApiPost生成的文档怎么添加响应示例?很简单:

使用apipost工具快速生成在线接口文档

小技巧之:快速克隆一个项目

有时候我们需要复制一个项目的数据,ApiPost如何克隆(复制)一个项目?

很简单:

使用apipost工具快速生成在线接口文档

小技巧之:resful风格的接口的路径变量

类似这样风格的接口:

http://example.com/api/users/1 //GET 获取标识为1用户信息

ApiPost支持把像这样的restful风格链接中的uid也就是1作为参数单独提出来比较方便调试和解释。

只需要把URL路径中的ID设置为

:变量名

即可。

使用apipost工具快速生成在线接口文档

这样的话,我们生成的文档就会类似:

使用apipost工具快速生成在线接口文档
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342