复制并打开文档地址就可以看到了完整的接口文档。
点击分享文档,即可获取对应的文档链接
接口调试是在开发阶段中使用最多的一个功能,利用ApiPost进行常规的接口调试功能
全局参数
然后重新生成文档,这个时候,就会包含我们的成功示例啦。
首先点击Mock服务,然后编辑Mock模板,右侧即可看到我们实时生成的Mock数据了
因为,后台管理和门户是有两套鉴权逻辑的,即上面提到的全局配置token就不能针对两个场景生效了!
那么最终发送的token值为:a1a9db893bb8a28ccb665d2af54d9417
目前常用的内置变量有以下几种:
下面我们利用这些常见的Mock变量,来生成一个Mock服务吧。
而前端与后端的沟通则是需要通过一个统一的文件进行沟通交流,即通过接口文档事先约定好后端的接口返回内容,然后大家就按照这个文档约定完成前后端的开发。并且一般接口文档都是通过后端人员编写的,维护流程也比较繁琐。
更多关于ApiPost的功能,还等待小伙伴去发现。好啦,本期就到这里啦。
下面是ApiPost的Json格式化功能,并且通过右侧的三角形,可以对数组元素进行展开或者合拢。在面对返回结果是一个数组,并且每个对象中字段很多的时候,这个功能就非常棒了。
ApiPost进行常规的接口调试功能
最近被群里小伙伴安利了一款接口管理工具ApiPost,陌溪在使用后觉的非常不错,在这里我也分享给大家。
还有一个让我非常喜欢的点,就是全局参数。
@guid():随机生成一个GUID,例:DEfbBBBf-7A23-a4DB-9BB1-57BCFf5FB5fc@integer(1,100):随机生成一个1~100的整数@datetime('yyyy-MM-ddHH:mm:ss'):返回一个随机的日期和时间字符串。例:1977-11-1703:50:15@url('http'):生成随机一个httpURL@email():生成一个随机email邮箱@province():随机生成一个中国省份@city():随机生成一个中国城市@title():随机生成一个标题@cname():随机生成一个中文名称@cparagraph():随机生成一段中文文本
ApiPost的Json格式化功能
ApiPost包含了以下四种功能,同时具备接口调试,接口文档,以及Mock工具,以及接口流程测试。
填写参数描述是我们最烦恼的一件事情,尤其对于很多接口来说,往往具有大量相同名称、相同意义的参数,假如每次都需要手动录入,将会是一件非常耗时、低效的事情。
全局参数
ApiPost=API接口调试工具+接口文档快速生成+Mock工具+接口流程测试
有更细心的小伙伴,可能又会发现,这里为啥缺了点返回值呢?那是因为APIPOST不会把发送后的实时响应的数据作为响应示例。这个时候,需要手动的将实时响应结果导入或者复制到对应的成功响应示例和错误响应示例。
Mock工具
没有对比就没有伤害,在看看Postman的输出,每次只能把结果复制出来,然后打开Json在线格式化,才能够看到返回的结果,简直增加了额外的负担。
Postman自带的Pretty功能
新建接口,并添加断言打开流程测试,新建一个流程向流程添加测试接口选择环境,点击开始测试查看返回的测试接口
这个时候,我们可以通过ApiPost参数描述库解决这个问题,通过自定义参数描述库,我们可以将本项目用到的大量参数进行预注释。
通过点击接口名称查看请求的请求和响应参数信息
在点击上方的复制链接,即可把这个接口的mock请求交给前端小伙伴了,然后各种进行合作开发。
测试流程
代码格式化
Api接口调试
在ApiPost中,创建一个流程测试需要如下步骤:
全局参数
不知道小伙伴们有没有发现一个问题,就是在生成接口文档的时候,还是需要自己填写参数描述。
并且,我们在填写完某个描述后,会自动同步到参数描述库,以后如果匹配到了相同的名称,会自动生成对应的描述,简直是一劳永逸的方法。
接口文档快速生成
ApiPost支持参数直接引用mocjs变量,点击下方可以查看内置Mock字段变量有哪些
在线Json格式化
API接口调试工具:常见的有Postman、Postwoman等等接口文档快速生成:常见的接口文档工具有Swagger和smart-doc,但是对代码侵入性比较强。Mock工具:主要用于前端根据接口生成对应的数据,如RAP等工具。接口测试:常见的接口测试工具有JMeter
在上面的示例中,我们需要给接口填写对应的鉴权请求头,才能够请求后台获得数据。
流程测试界面如下:
那如果我还想同时测试门户类相关接口,或者是后台管理相关接口,那怎么办呢?
细心的小伙伴可能会发现,这个请求参数上没有相关字段的介绍,我们回到刚刚的ApiPost页面,点击提取字段和描述,然后填入对应的字段名称。
同时ApiPost也是国人开发的一款接口管理工具,致力于打造更好用的、中文的、接口调试与文档管理工具
配置完成后,以后添加的接口,再次请求后台时,就会携带全局定义的请求头过去。同理,还支持全局的Query以及Body,可以把一些不变的请求参数都配置好全局参数,这样会让我们编写接口请求时,省下很多时间~
我们都知道,在后端接口还没有开发完成的时候,接口是无法获取数据的,那么前端小伙伴就需要通过Mock事先编写好API的数据生成规则,由工具动态生成API的返回数据。通过访问Mock来获得页面所需要的数据,就可以轻松地完成对接工作。前后端人员只需要定义好接口文档就可以开始并行工作,互不影响,只在最后的联调阶段往来密切。
让我感觉最舒服的是,对于返回的参数是可以进行Json格式化的,下面是Postman自带的Pretty功能。
通过这个方法,可以随时随地的测试以及更新文档,简直是后端小伙伴的福音~
ApiPost可以让你在没有后端程序的情况下能真实地返回接口数据,我们可以用ApiPost实现项目初期纯前端的效果演示,也可以用ApiPost实现开发中的数据模拟从而实现前后端分离。
流程测试是针对一个接口集合的测试,选择相应的环境,可以作为一系列请求一起运行。当您想要自动化API测试时,流程测试非常有用。点击开始,接口集合会并发的像服务器发出请求,最后会按照定义好的测试校验模块给出测试结果。对于测试同学来说,这是一个非常不错的功能。
同时还有对应的返回值字段描述
然后重新发布,即可看到每个字段的含义了
文章为作者独立观点,不代表股票交易接口观点