一. 写在前面
之前没有怎么接触过API,唯一的一次是调用天气预报的API, 不过那个是一个XML的文件形式,可以用浏览器打开。很神奇的是会自动更新,细想起来现在好像也没有明白那是个什么原理。
这一次的需求是通过Java调用testrail的API。刚开始上来有点懵逼,很直接的就把别人给我API 通过网页打开。结果当然是被赤裸裸的嘲笑啦,来,放postman~
二. 关于postman的介绍
Postman 是一个很强大的 API调试、Http请求的工具, Postman 官网(https://www.getpostman.com/downloads/)有文档介绍,可以快速开始第一条的请求。https://learning.getpostman.com/docs/postman/launching_postman/installation_and_updates/?_ga=2.262405705.455984974.1566293562-1931005962.1566293562
如果这个快速操作的文档真的可以满足刚接触的新手的话,那我就不写这篇水文了。对,我就是那个刚接触的。
下面将以testrail 的API 接口请求为例。
testrail 的API文档地址:http://docs.gurock.com/testrail-api2/start
我自己申请了一个免费的testrail 的空间,base URL 为 https://xxxx.testrail.com
根据testrail的文档可知,该testrail空间的API URL为 https://xxxx.testrail.com/index.php?/api/v2/
1: 可以选择get/post 等请求类型
2:放入你需要请求的URL,这里面的内容包括Host 的base URL(必须写),URL的另一部分是传输数据以及连接参数等部分,这一部分可以通过2直接输入,也可以在6和7中写入键值对,内容会自动同步到2中。
3: 3 下面的内容即为6和7,不再赘述
4: Athorization和登录认证有关,因为有的请求并不能直接访问,需要登录才可以被请求成功。
这里显示的是basic 认证,这种方法是通过明文登录请求,postman会自动返回一串Authorization的值。将该键值对写入headers 5 中。
如此,可以通过send 按钮,做get 请求了。如果成功,则返回一串
三.你可能会请求不成功
1.按照报错提示修改postman 设置中的各项
2.通过code 查看HTTP 请求格式中有无不正当的空格。在各个key-value 项中去掉不正当的空格(说到这里就好气)
3.最有可能的会是你testrail 网页是否开启了api访问权限。