使用apipost调试api接口并快速生成接口文档的一些小技巧,比postman更好用

举报
小台分享 发表于 2020/05/20 17:26:54 2020/05/20
【摘要】 提升开发、测试团队效率 可直接生成文档的API调试、管理工具

apipost是一款兼顾api接口调试(postman的主要功能)和接口文档生成(淘宝rap的主要功能)的工具,而且在2者的基础上,增加了很多更加人性的操作,不用不知道,一用就甩不掉了。

技巧一:快速导入参数

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

导入格式支持key-valuejson格式:


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

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

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

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

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

1-2json格式导入示例:

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

{

      "id": 123,

      "title": "我是标题"

}

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

技巧二:参数注释自动识别

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

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

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

id我是文章Id”

title我是文章标题

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

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

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

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

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

强烈建议您安装使用,官网:https://www.apipost.cn/

 


【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。