MyPostMan：按照项目管理接口，基于迭代生成接口文档、执行接口自动化联合测试

MyPostMan 是一款类似 PostMan 的接口请求软件，不同于 PostMan 的是，它按照项目（微服务）、目录来管理我们的接口，基于迭代来管理我们的接口文档，按照迭代编写自动化测试用例，在不同环境中均可运行这些用例。

按照项目、文件夹管理我们的接口

接口详情可以查看我们接口的入参和返回示例、字段含义说明等

每个迭代会包含多个项目、多个文件夹的接口。

以迭代为单位，生成接口文档，可以标注一些这个迭代的注意事项，可导出分享。

把这个迭代涉及的一系列接口入参和返回串联起来调用，就构成了这个迭代接口的一个测试用例。

我们迭代编写单测入参和断言支持大量常用的情景输入，如引起前面步骤的数据，读取项目环境变量数据等。

发送网络请求，和 PostMan 相比，支持引用环境变量和使用随机数、随机字符串等作为参数。环境变量独立于项目和环境。

下载

MyPostMan项目地址：
MyPostMan 项目地址https://gitee.com/onlinetool/mypostman

软件下载（windows）：Windows 下载地址http://cdn.fanghailiang.cn/MyPostMan-Setup-0.0.1.exe

软件下载（mac）：

mac 下载地址http://cdn.fanghailiang.cn/MyPostMan-0.0.1.dmg

使用

开始旅程.mdhttps://gitee.com/onlinetool/mypostman/blob/master/doc/%E5%BC%80%E5%A7%8B%E6%97%85%E7%A8%8B.md

准备接口调用 key

在以下教程中，我们使用聚合数据的（天气预报）相关接口演示如何使用 MyPostMan 进行接口调用、文档生成、自动化测试。

首先你需要申请一下 key，如果嫌麻烦，可以使用我的 2c173c8a08cb275c6925c775c038903b ，但有限额，你大概率调不通～[沮丧]

环境、微服务、环境变量

在开始之前，先要设置好这些信息。我们企业中的环境一般分为开发、测试、预发布、线上等环境。通常我们只对某几个项目（微服务）拥有权限。不同的项目在不同环境中部署后，又会存在不同的访问地址，我们使用环境变量来管理这些在不同项目、不同运行环境中呈现不一样的字符串。

点击设置 -> 开发环境 -> 新增来创建我们的开发环境

点击设置 -> 微服务 -> 添加来创建我们的项目

在环境变量中设置我们这个项目在这个环境中，接口访问的 host 信息，点击设置->环境变量->选择项目（天气预报）->选择环境（本地环境）->api_host->编辑，下面填写的地址为 http://apis.juhe.cn/simpleWeather/ (注意，要求必须是以 http:// 或者 https:// 开头且以 /结尾的 url 地址)

再新建一个环境变量，把我们准备阶段辛苦申请的 appKey 填进去。点击设置 -> 环境变量 -> 添加。参数名称填写 appKey，参数值填写你刚刚申请的 key，我的填写 2c173c8a08cb275c6925c775c038903b

以上这些，相当于我们初始化了一个项目。完成后效果如下

迭代、接口测试、编写文档

我们这个天气预报项目研发第一个迭代开发了两个接口：查询支持的城市列表 和 根据城市查询未来天气，

先创建一个迭代，在这个迭代里生产我们的接口文档，编写测试用例，最后迭代完成，接口合并到项目中，上线！

点击设置 -> 版本迭代 -> 新增

我们现在通常是一个月一个迭代，因此我的迭代名称就是 天气预报 2406，因为我这个迭代涉及的项目就一个天气预报项目，所以微服务只选了一个。通常情况下，你们一个迭代会涉及很多个项目，都把它们选出来吧，多选漏选也无所谓，可以在设置 -> 版本迭代找到你的版本迭代，进行修改的。迭代说明是一个 markdown 的文案，这会在你们迭代的文档顶部展现出来，你、前端、测试所有想要看迭代接口文档的人都会看到～

当你的迭代上线后，可以关闭这个迭代，相当于归档，迭代变得不可修改，所有接口会按照关闭的先后顺序覆盖到你项目的接口列表中。

测试一下我写的查询支持城市列表接口是否正确：请求 -> 发送请求，选择项目（天气预报）-> 选择环境（本地环境）->请求方式（GET）->地址（cityList），参数 key 值 {{appKey}} （“{{”开头，“}}”结尾的值会引用我们环境变量的数据，最终发送网络请求的数据是环境变量设置的值而不是这个字符串本身；这个界面就是参照 PostMan；在你输入“{{”时，会自动提示出这个项目下所有的环境变量，因此输入不会太困难;）。点击发送请求按钮可以得到下图的响应，代表查询天气预报接口是可用的。