推荐一款前后端协作开发神器apipost：postman+swagger+mock的复合体(代码片段)

关键词：

大家好，我是路飞！今天这篇文章，给大家介绍一款非常好用的国内软件自研发的开发辅助软件 ApiPost！

作为一个名服务端开发者，我们在日常工作中离不开接口测试、接口文档编写、Mock 数据测试、前后端接口联调。为了完成这些任务，我们经常需要用到 Postman、Swagger、Mock Js等等，而今天这款软件是恰好包含了这三者所有的功能，以及额外的扩展功能！

ApiPost = Postman + Swagger + Mock

一、什么是ApiPost？

1、介绍

• 官网地址：apipost.cn

ApiPost是一款将接口调试+接口文档快速生成+接口文档规范化管理+Mock API+接口流程测试集成一体的辅助开发软件。

ApiPost产生的初衷是为了提高研发团队各个角色的效率！产品的使用受众为由前端开发、后端开发和测试人员以及技术经理组成的整个研发技术团队。

2、面向的用户群体

• 前端开发人员：支持接口文档预览、接口Mock数据、接口调试、前端代码自动生成。
• 后端开发人员：支持接口文档自动生成、支持接口文档测试调用。
• 测试开发人员：支持接口调试、接口自动化测试。
• 研发经理：规范接口文档管理、提升整体研发团队效率。

二、ApiPost下载与安装

1、下载

• 下载地址：https://www.apipost.cn/download.html

选择合适自己电脑操作系统的安装包下载即可，这里我简单演示一下Mac和Windows电脑上的安装流程。

2、安装

2.1、Mac上安装

我的办公电脑是M1芯片的MacOS系统，所以这里选择下载 Mac 客户端（arm64，适配M1芯片） 。dmg结尾的安装包下载完毕后，直接双击运行即可安装：

2.2、Windows上安装

Windows电脑上我选择 Window 64位 客户端 ，下载完毕后直接运行exe文件即可。



安装完成后，我们来简单实操一下ApiPost的一些常用功能！

三、ApiPosts实操

• 官方帮助文档：APIPOST 使用文档

1、HTTP请求接口（获取天气预报信息）

ApiPost在测试请求接口时，和Postman一样，主要注意下面几个部分的参数配置即可：

• Header 参数：可以设置或者导入 Header 参数，cookie也在Header进行设置。
• Query 参数：Query 支持构造URL参数，同时支持 RESTful 的 PATH 参数（如:id）。
• Body 参数：Body 提供三种类型 form-data / x-www-form-urlencoded / raw ，每种类型提供三种不同的UI界面。这三者分别对应提交表单参数、提交有文件的表单参数、发送JSON对象或者其他对象。

这里简单测试一下查询所在城市天气信息的天气预报接口调用：

http://apis.juhe.cn/simpleWeather/query?city=杭州&key=351e0xxxxxxxxxxxxxx8b266

完整的请求结果如下：

	"reason": "查询成功!",
	"result": 
		"city": "杭州",
		"realtime": 
			"temperature": "14",
			"humidity": "55",
			"info": "晴",
			"wid": "00",
			"direct": "东风",
			"power": "3级",
			"aqi": "140"
		,
		"future": [
			
				"date": "2022-02-27",
				"temperature": "8/14℃",
				"weather": "晴转多云",
				"wid": 
					"day": "00",
					"night": "01"
				,
				"direct": "东风转持续无风向"
			,
			
				"date": "2022-02-28",
				"temperature": "9/20℃",
				"weather": "多云转小雨",
				"wid": 
					"day": "01",
					"night": "07"
				,
				"direct": "持续无风向转西北风"
			,
			
				"date": "2022-03-01",
				"temperature": "7/15℃",
				"weather": "小雨",
				"wid": 
					"day": "07",
					"night": "07"
				,
				"direct": "西北风转持续无风向"
			,
			
				"date": "2022-03-02",
				"temperature": "7/17℃",
				"weather": "晴转阴",
				"wid": 
					"day": "00",
					"night": "02"
				,
				"direct": "持续无风向"
			,
			
				"date": "2022-03-03",
				"temperature": "8/14℃",
				"weather": "小雨转小到中雨",
				"wid": 
					"day": "07",
					"night": "21"
				,
				"direct": "持续无风向"
			
		]
	,
	"error_code": 0

2、使用ApiPost发送请求给自己的博客文章点赞

操作步骤：

• 1、点赞请求URL：https://blog.csdn.net//phoenix/web/v1/article/like
• 2、请求类型：POST
• 3、设置Cookie：在文章列表页F12打开控制台，拷贝请求Cookie信息。
• 3、Body请求参数：articleId: 122262651

从上面两个案例，可以看到，ApiPost在接口测试、接口调用方面相比于纯英的Postman，对国内开发者友好很多，而且在一些使用细节上既保留了Postman原有开发者用户的操作习惯，还在原来基础上增加了很多新的功能。

那么，ApiPost就只是一个增强版的Postman吗？

肯定不是呀，下面我们来康康使用ApiPost如何快速一键生成接口文档！

3、一键生成接口文档

我们知道，在前后端协作开发时，接口文档是必须要的。而接口文档的编写任务往往交给后端同学去负责，需要给出接口的各种参数要求以及参考实例等等，非常繁琐。

为了前后端协作便利，很多公司使用 Swagger 作为接口文档生成工具，嵌套在后端服务中，当后端开发着完成后端接口编写，就可以自动生成接口文档。

但是 Swagger 需要在后端模块添加额外的 Swagger 集成代码。而 ApiPost 刚好可以把 Swagger 和 Postman 二者的功能合二为一，对开发者带来极大的便利性！如下图所示：

点击分享文档/分享项目查看自动生成的接口文档：

文档如下所示：

4、Mock

ApiPost 可以让前端开发者在没有后端程序的情况下能真实地返回接口数据，可以用 ApiPost 实现项目初期纯前端的效果演示，也可以用 ApiPost 实现开发中的数据模拟从而实现前后端分离。

• 官方文档：ApiPost中使用Mock

编写mock规则：

Mock 规则模板支持类型丰富（5.4版本起）。

• 基本数据(固定json结构)

  "code": "0",
  "data": 
    "name": "张三丰",
    "age": 100
  ,
  "desc": "成功"

• 基本数据(Mock随机json结构)

  "code": "0",
  "data": 
    "list|20": [
      "name": "@name",
      "age": "@integer(2)"
    ],
    "url": "https://echo.apipost.cn"
  ,
  "desc": "成功"

如图所示：

将生成的mock URL地址发给前端：

这样前端就可以使用您模拟的数据进行先一步的调试开发了。当您的接口完成后，再替换回来即可。

注：APIPOST的 mock 是基于mock.js 开发的。具体文档可以 参见 mock.js 详细文档。

5、全局参数和目录参数设置

5.1、全局参数

在实际项目中，对于一批接口，往往具有相同的请求参数。此时，我们可以利用全局参数或者目录参数实现。

例如：常见的token令牌参数，假使我们请求项目下的任何接口都需要在header带上token参数，那么我们当然可以每个接口的header参数都写一个token，但是这样的话十分不利于后期维护、修改。

打开全局参数管理器，在全局header填上token参数：

那么我们每次发送接口，都会在请求header中自动带上该参数：

全局query和全局body的使用方法跟全局header类似，不再赘述。

5.2、目录参数

目录参数的作用和全局参数雷同，只是作用域不一样，B目录下的接口不会使用同级的A目录的目录参数作为发送参数。

我们可以通过编辑目录进行目录参数的填写：

那么我们每次发送该目录下的接口，都会在请求header中自动带上该参数：

5.3、参数的优先级

当全局参数、目录参数、接口中都使用了同一个参数时，最终会按照以下优先级读取参数值：

单个接口 > 目录参数 > 全局参数

如上面的示例，如果全局参数、目录参数、接口中都定义了header参数token：

全局参数：token值为：698d51a19d8a121ce581499d7b701668 // 最低优先级
目录参数：token值为：b50e345cc9febd86dedecc551ebcc505 // 其次优先级
单接口参数：token值为：a1a9db893bb8a28ccb665d2af54d9417 // 最高优先级

那么最终发送的token值为：a1a9db893bb8a28ccb665d2af54d9417

6、流程测试

流程测试是针对一个接口集合的测试，选择相应的环境，可以作为一系列请求一起运行。点击开始，接口集合会并发的像服务器发出请求，最后会按照定义好的测试校验模块给出测试结果。

6.1、流程测试过程

创建一个流程测试需要如下步骤：

1、新建接口，并添加断言
2、打开流程测试，新建一个流程
3、向流程添加测试接口
4、选择环境，点击开始测试
5、查看返回的测试接口

流程测试界面如下图：

6.2、查看流程测试中单个接口的信息

通过点击接口名称查看请求的请求和响应参数信息。

总结

除了上面总结的一些常用功能，ApiPost还支持其他一些功能，比如：

• 接口回收站
• 自动生成代码
• 多人协作管理
• 项目管理
• Cookie管理器
• 预执行脚本和后执行脚本
• …

整体上来看 ApiPost 无论是功能种类方面还是用户体验方面都比之前用的其他软件更具优势，相当于同时把 Postman、Mock、Swagger 的功能压缩为一个开发辅助软件，真的非常 Nice，关键是完全免费提供给用户使用，白嫖党福音！

不得不说，ApiPost 相比于 Postman ，它是一款更懂中国程序员的研发协同工具。

Apipost官方已经开通企业微信社群服务，如果在使用过程中有任何问题可以直接@客服，回复速度很快，可以进群里交流技术问题或者撩客服小姐姐。


最后，也希望大家多多支持这一款很良心的国产自研发远程办公软件，希望国内软件研发生态蒸蒸日上，也希望各位老板能给博主一个三连(点赞、收藏、加关注)鼓励支持一下~，谢谢大家呀！

apipost简介

参考技术A总述ApiPost是一款支持模拟POST、GET、PUT等常见HTTP请求,支持团队协作,并可直接生成并导出接口文档的API文档、调试、Mock、测试一体化协作性能非常强大的工具。简单说：ApiPost=Postman+Swagger+MockApiPost产生的初衷是为了提高... 查看详情

推荐一款神级api接口管理神器

...有点feel，那就点个赞再走哦。文章目录一、前言二、ApiPost简介怎么制作简洁精准的API文档？要有层次有结构精准具象界面友好可搜索三、ApiPost是什么四、ApiPost的亮点4.1、与这些开源产品相比，ApiPost的不同之处在于&... 查看详情

推荐一款神级api接口管理神器

...有点feel，那就点个赞再走哦。文章目录一、前言二、ApiPost简介怎么制作简洁精准的API文档？要有层次有结构精准具象界面友好可搜索三、ApiPost是什么四、ApiPost的亮点4.1、与这些开源产品相比，ApiPost的不同之处在于&... 查看详情

开发神器自动化测试用apipost！

文章目录产品介绍测试用例待测接口搬运麻烦？Apipost一键添加代码不会写？可视化操作免敲代码1.条件控制器：判断一个变量是否满足某个条件，由此决定该控制器下接口是否运行。2.次数控制器：while控制器&... 查看详情

开发神器自动化测试用apipost！

文章目录产品介绍测试用例待测接口搬运麻烦？Apipost一键添加代码不会写？可视化操作免敲代码1.条件控制器：判断一个变量是否满足某个条件，由此决定该控制器下接口是否运行。2.次数控制器：while控制器&... 查看详情

postman的霸主地位被动摇了!

...然有比Postman还好用的软件！这个API开发调试神器就是ApiPost。ApiPost是一款支持模拟POST、GET、PUT等常见HTTP请求,支持团队协作,并可直接生成并导出接口文档的 查看详情

再见postman，我选择apipost！

...;我是Beyonce。最近，被身边朋友安利了一款神器：ApiPost。它将Swagger、Postman、RAP、JMeter的功能完美的做了整合，一款工具，全部搞定。下载地址：https://www.apipost.cn/download.html?fr=psjkx什么是ApiPost？它是一... 查看详情

推荐一款可视化配置nginx的神器

点击关注公众号，实用技术文章及时了解Nginx是前后端开发工程师必须掌握的神器。该神器有很多使用场景：比如反向代理、负载均衡、动静分离、跨域等等。把 Nginx 下载下来打开 conf 文件夹的 nginx.conf 文件，Ngi... 查看详情

前后端联调，比postman更好用的国产接口调试工具：apipost

降本增效是企业追求的永恒目标。如今，前后端分离早已成为互联网的标配，大家在享受这种开发模式带来的便利同时，也体会到一些痛点，比如：一个需要几十个、上百个应用协作配合的项目，其中可能... 查看详情

强大的apipost要取代postman了吗？

文章目录1背景2Apipost简介3Apipost下载4Apipost功能介绍新建种类目录请求方式接口代码生成接口性能压测笔记功能在线文档项目分享全局设置5适用人群6总结1背景在项目开发过程中，不管是我们后端自己开发的接口，还是对... 查看详情

apipost:一款值得使用的利器(代码片段)

文章目录Apipost:一款值得使用的利器主角登场PostmanvsapiPostswaggerVSapipostswagger优点：swagger的缺点apipost对比：总结Apipost:一款值得使用的利器主角登场Apipost是一个支持模拟POST、GET、PUT常见的HTTP请求，支持团队协作，... 查看详情

推荐一款超好用码云start超4.9k采用前后端分离开发的小程序商城源码

...的小程序商城源码也非常的多，那么今天我在这里给大家推荐一款安装简单，系统源码稳定，二次开发便捷，采用tinkphp+vue+elment-ui开发的小程序商城，特别适合中小企业和个人使 查看详情

又一款接​私活神器！springboot+vue通用后台管理系统，真香！！

参考：https://el-admin.vip/guide/又一款接私活神器，统一后台系统，前后端分离，别再乱找了！这是一款基于SpringBoot2.1.0、Jpa、SpringSecurity、redis、Vue的前后端分离的后台管理系统，项目采用分模块开发方式，权限控制采 查看详情

前后端联调，比postman更好用的国产接口调试工具：apipost

降本增效是企业追求的永恒目标。如今，前后端分离早已成为互联网的标配，大家在享受这种开发模式带来的便利同时，也体会到一些痛点，比如：一个需要几十个、上百个应用协作配合的项目，其中可能... 查看详情

api管理神器—apipost

API管理神器—Apipost1.背景作为互联网工作者，只要是从事开发的，无论前端、后端、测试。而一般完成整个接口的管理的解决方案如下：使用Swagger管理API文档使用Postman调试API使用RAP等根据MockAPI数据使用JMeter做API自动... 查看详情

api管理神器—apipost

API管理神器—Apipost1.背景作为互联网工作者，只要是从事开发的，无论前端、后端、测试。而一般完成整个接口的管理的解决方案如下：使用Swagger管理API文档使用Postman调试API使用RAP等根据MockAPI数据使用JMeter做API自动... 查看详情

[分享]利用apipost生成mock数据

...的时机也提前了，有利于整个产品质量以及进度的保证。ApiPost简介：ApiPost是一个支持团队协作，并可直接生成文档的API调试、管理工具。它支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员不可多得的... 查看详情

前端如何高效的与后端协作开发(代码片段)

...用的渲染方式分为服务器端渲染和客户端渲染，当下比较推荐的方式是客户端渲染，数据使用全ajax的方式进行交互。除非在一些不得不使用服务器端渲染的情况下（如门户、电 查看详情