接口调试与文档生成软件(ApiPost) 32位和64位

　　ApiPost是一款专业的接口调试与文档生成软件，此工具非常适合应用于团队开发，用户可以使用其进行API调试工作，内置的功能模块都可以对接口进行各种调试，以便于满足用户的使用需求；不仅如此，程序系统还内置了管理工具，可以实时对您想要进行调试的APL接口进行管理；如果用户在使用过程中需要对POST、GET进行模拟，或者对PUT等等常见请求进行模拟，可以直接使用此工具进行实现；对于一个开发人员来说，一个完美的助手可以为整个开发计划提供保障，不仅可以大大缩短开发周期，还可以使用户在管理时更加得心应手，此工具是后台接口开发者或前端、接口测试人员不可多得的工具；需要的用户可以下载体验

软件功能

　　提升开发、测试团队效率

　　可直接生成文档的API调试、管理工具

　　ApiPost是一个支持团队协作，并可直接生成文档的API调试、管理工具

　　支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员不可多得的工具

　　快速生成、一键导出API文档

　　ApiPost不仅可以快速生成接口文档，还支持导出离线html文档。方便您部署接口文档到您的本地甚至局域网服务器

　　支持携带COOKIE请求，模拟登录

　　支持Cookie管理，发送接口时，可以携带自定义的Cookie进行模拟登录，从而方便测试一些需要登录才能访问的API

软件特色

　　更方便

　　支持接口调试的同时快速生成、一键导出各种格式的api文档。开发、测试人员再也不用头疼接口文档的编写。

　　更安全

　　全站实现https协议。同时，在线版数据完全以加密的形式存储在云端，100%隐私安全保障。

　　清晰的使用流程，跨平台支持

　　ApiPost拥有Window客户端、Mac客户端、Linux客户端、FireFox拓展插件、Chrome拓展插件5大版本

     软件界面清爽，使用简单，功能类似PostMAN和Rap的结合，更适合中文版的国人使用

安装步骤

　　1、用户可以点击本网站提供的下载路径下载得到对应的程序安装包

　　2、只需要使用解压功能将压缩包打开，双击主程序即可进行安装，弹出程序安装界面

　　HandBrake安装程序将提供在安装最新版本之前删除先前版本的功能。

　　3、同意上述协议条款，然后继续安装应用程序，点击同意按钮即可

　　4、可以根据自己的需要点击浏览按钮将应用程序的安装路径进行更改

　　5、弹出以下界面，用户可以直接使用鼠标点击下一步按钮，可以根据您的需要不同的组件进行安装

　　6、桌面快捷键的创建可以根据用户的需要进行创建，也可以不创建

　　7、弹出应用程序安装进度条加载界面，只需要等待加载完成即可

　　8、根据提示点击安装，弹出程序安装完成界面，点击完成按钮即可

使用说明

　　ApiPost V3 全局参数的使用

　　对于一些参数，我们可能每个接口都会用到。比如说校验登陆的token。这样的话，就没必要每个接口都设置一个这样的参数，我们可以放到全局参数里。如下图：

　　全局参数支持header、query、body等类型，同时也是支持变量的。

　　如上图所示，这个token参数在每个接口请求时，自动带到body里进行发送。

　　ApiPost的预执行脚本和后执行脚本

　　从前面的文档可以看出，ApiPost的预执行脚本和后执行脚本主要是用来定义变量。但是它们有什么区别呢？

　　预执行脚本

　　在当前接口发送请求前执行的脚本，可以理解为beforeSend的时候执行。

　　一般在这里，我们可以设置一些前置的变量，比如{{url}}或者其他发送时需要携带的变量。

　　变量的定义方法，可以参考：ApiPost的变量的定义和使用

　　后执行脚本

　　在当前接口发送请求结束后执行的脚本，可以理解为complate的时候执行。

　　一般在这里，我们可以将请求结束后的响应绑定到某个变量，比如登陆接口响应返回的token。

　　另外，后执行脚本还可以进行一些校验工作，从而实现流程测试的目的。比如，我们可以在这里校验当前接口的响应码是否是200:

　　apt.assert('response.raw.status==200');

　　附：内置响应变量：

　　response.raw：原始响应数据

　　调用示例：

　　response.raw.status //响应状态码（200、301、404等）

　　response.raw.responseTime //响应时间（毫秒）

　　response.raw.type //响应类型（json等）

　　response.raw.responseText //响应文本

　　response.json ：json格式的响应数据

　　调用示例如上面示例：

　　response.json.data.token //也可以 response.json.data["token"]

　　response.headers ：响应头

　　调用示例：

　　response.headers.server //也可以 response.headers["server"]

　　response.cookies ：响应cookie

　　调用示例：

　　response.cookies.PHPSESSION //也可以 response.cookies["PHPSESSION"]

　　使用ApiPost 的Path变量方便的测试restful接口

　　restful的接口格式似乎是一阵风，到处都在说，这种风格的确很有意义，类似：

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

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

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

　　:变量名

　　即可。

　　这样的话，我们生成的文档就会类似：

　　使用ApiPost 下载响应数据到本地

　　ApiPost V3版本开始，已支持下载响应数据到本地，格式不限。如图中所示。

　　为什么我看不到同事的协作数据？

　　很多小伙伴问：为什么我同事修改了接口数据，而我这里看不到，重启软件都不行！ApiPost有Bug！

　　其实，这个不是Bug，而是协作数据的一种保护。

　　为了防止协作数据替换，只有点击左侧的“下载协作数据”按钮才会替换云端（协作）数据到本地（下图）。

　　apipost接口测试测试结果不对？

　　apipost接口测试测试结果不对？

　　排查以下几项：

　　1、如果您是在测试上传文件接口，请不要在header头里添加 content-type参数；

　　2、另外看看您是不是切换到了【响应】选项：

　　ApiPost自动化测试基础之：接口参数依赖的情景处理

　　ApiPost V3版本的参数依赖处理方式同旧版雷同。

　　什么是接口参数依赖：

　　接口参数依赖又称作接口依赖，简单点说就是后面的接口要用到前面的接口产生的数据。

　　比如：我们一个接口B需要A接口返回的参数token作为自己的请求参数。常见的场景如：访问一个需要登陆才能浏览的接口。

　　ApiPost如何处理参数依赖？

　　为了便于演示，首先，我们准备2个接口：

　　get_token接口：

　　请求地址：{{url}}get_token.php

　　它将返回一个token参数。如图：

　　need_token接口：

　　请求地址：{{url}}need_token.php

　　它需要get_token接口返回的token参数作为自己的请求参数。

　　如上图所示，我们定义了一个环境变量token_var，由于此时尚未将其与get_token接口返回的token绑定，所以此时它原样输出了。

　　绑定get_token的响应结果token到环境变量token_var

　　此时点击get_token接口的【后执行脚本】，通过一个变量赋值，就可以将get_token的响应结果token到环境变量token_var。

　　此时，点击【发送】按钮，就可以把get_token接口返回的token绑定到环境变量token_var了。

　　我们进入need_token的接口，并点击发送，就会看到token已经是我们刚才获取到的token了。

　　注意：我们绑定完成后，我们需要先再次发送请求下get_token接口（执行绑定数据），再请求need_token接口。

　　附：响应类型对应关系：

　　response.raw：原始响应数据

　　调用示例：

　　response.raw.status //响应状态码（200、301、404等）

　　response.raw.responseTime //响应时间（毫秒）

　　response.raw.type //响应类型（json等）

　　response.raw.responseText //响应文本

　　response.json ：json格式的响应数据

　　调用示例如上面示例：

　　response.json.data.token //也可以 response.json.data["token"]

　　response.headers ：响应头

　　调用示例：

　　response.headers.server //也可以 response.headers["server"]

　　response.cookies ：响应cookie

　　调用示例：

　　response.cookies.PHPSESSION //也可以 response.cookies["PHPSESSION"]

更新日志

　　增加 测试模式下，可以拖动控制左右两分栏宽度啦；

　　增加 全局共享cookie，实现一处登陆，全局共享的cookie；

　　优化 响应cookie展示问题；

　　修复 文档request_body部分情况下不展示的问题；

　　修复 解决body含有file参数时，同接口下其他参数可能无法保存value的bug；

　　修复 2.5.6版本环境变量无法切换的bug；

　　修复 下拉框过长时无法显示的bug；

　　本次新增10余处新功能，优化6处现有功能，修复若干已知Bug。

　　新增 存储某接口最后的环境参数；

　　新增 支持对自签名证书接口的发送响应；

　　新增 接口搜索支持URL搜索；

　　新增 Input框改成自动大输入框；

　　新增 假如接口返回的是Zip、rar、gz、Doc、Pdf、ppt、Excel、音频、视频等常见文件类型，支持下载为文件（仅限客户端版本）；

　　新增 客户端新增导入postman数据菜单选项新增 根据json导入请求参数；

　　新增 raw请求参数支持JSON5注释写法；

　　新增 raw也支持快速导入参数啦；

　　新增 请求参数转raw json功能；

　　优化 响应数据支持复制；

　　优化 文档再编辑直接定位到当前接口；

　　优化 raw请求参数/响应示例的错误提示；

　　优化 接口修改红点及“当前标签尚未保存，确认关闭该标签吗？”的提示；

　　优化 未勾选某指定参数类型时，不再发送相关数据；

　　优化 query参数操作，未勾选情况不会删除；

　　修复 接口保存会导致绑定的环境变量失效的bug；

　　其他细节调整 。

　　修复 部分非标准响应头无法预览的Bug。

　　增加 客户端支持apipost:// 协议，可以在网页里直接打开apipost客户端啦；

　　增加 postman数据导入功能；

　　增加 测试用例增加全局变量 RawResponse ：原始响应数据，包含此次请求返回的所有原始数据；

　　增加 二级目录支持，接口可以保存在子目录啦；

　　增加 目录编辑可以选择父目录；

　　增加 请求参数增加是否必填选项；

　　增加 响应参数批量删除功能；

　　增加 私密键值对、Bearer auth、Basic auth 认证支持 ；

　　增加 响应为图片时，直接预览；

　　优化 接口更改红点提示功能，修复未修改状态下同样提示已修改的bug；

　　优化 客户端 文档编辑；

　　优化 目录保存功能；

　　优化 单点登出用户重新登录不重新覆盖加载；

　　优化 接口排序功能；

　　优化 文件夹排序功能；

　　优化 变更参数导入时以:符号代替|符合隔开，方便直接复制chrome的请求参数；

　　优化 拖拽视觉效果；

　　优化 左侧导航宽度比例；

　　优化 接口搜索；

　　优化 选择框样式；

　　优化 URL转query参数的算法；

　　修复 部分header（referer/dnt/origin等）参数不支持的bug；

　　修复 清除底层大量冗余代码，优化性能；

　　其他 细节优化；

　　修复 GET请求参数会发送2次的Bug【重要】；

　　增加 接口输入保留现场功能（自动），避免数据被同步或者保存后的自动同步替换【重要】；

　　修复 响应参数重新导入后，部分响应参数描述会重置的Bug【重要】；

　　修复 响应参数为数字类型时，无法绑定到环境变量的Bug【重要】；

　　优化 从URL自动映射Query参数时，不影响已输入参数描述【重要】；

　　增加 文档描述字段；

　　增加 导出Markdown格式文档功能【重要】；

　　增加 自动将url参数转化成query参数功能【重要】；

　　增加 自动将query参数转化成url参数功能【重要】；

　　增加 raw 参数文档描述功能【重要】；

　　增加 请求参数勾选功能【重要】；

　　增加 请求参数清空功能，用于接口克隆后的快速处理；

　　增加 5 个内建变量【重要】：

　　{{$guid}} //生成GUID

　　{{$timestamp}} //当前时间戳

　　{{$microTimestamp}} //当前毫秒时间戳

　　{{$randomInt}} //0-1000的随机整数

　　{{$randomFloat}} //0-1000的随机浮点数；

　　优化 全局注释操作提示（原来会遮挡text输入，现在移到了右侧）；

　　优化 协作环境变量的选中状态不再同步（避免同事切换环境，其他人的环境一同被切换）；

　　优化 响应参数重新导入后，会保留已编辑的参数描述【重要】；

　　优化 文档展示优化；

　　优化 ctrl+s的保存行为；

　　修复 快捷键不可用的Bug【重要】；

　　修复 响应参数绑定的环境变量无法协作同步的Bug；

　　修复 文档再编辑在部分分辨率下的布局错乱问题；

　　修复 环境变量的一处bug（split is not a function）【重要】；

　　修复 日期文件夹排序问题，按日期降序排列；

　　修复 环境名称过长时，环境设置图标错乱的Bug；

　　修复 测试流程名称过长时，图标错乱的Bug；

　　修复 Query参数1次删除不掉的Bug；

　　修复 参数值/参数描述为0时，无法保存的Bug【重要】；

　　修复 query/header参数无划过背景的Bug；