postman登录测试用例_测试用例管理系统TestRail API手册

关注BeTester，学习更多知识

让碎片成体系，让测试更专业

1、环境准备

1.1 接口文档

http://docs.gurock.com/testrail-api2/start

1.2 读懂接口文档

以项目相关接口为例

1.2.1 get_project 接口

1.2.2 add_project 接口

1.3 API类库（Python）

执行命令：pip install testrail 完成testrail类库的安装

2、登录认证

2.1 密码认证

使用密码认证方式直接使用明文密码访问是非常危险的，建议使用后面两种方式进行认证。

2.2 API Key认证

2.3 Basic 认证

如何获取Authorization的值？最简便的方法，打开Postman，使用明文密码发送一个请求后，Postman上的Headers就会返回Authorization信息。

3、常用组合接口场景

3.1 查询项目所有测试用例

TestRail的get_cases接口中，不支持直接获取整个用例项目的所有用例。为了获取用例项目的所有用例，我们可以先获取该项目下的所有测试套，然后再组合各个测试套下的测试用例。
（a）获取项目所有测试套：get_suites。
（b）获取测试套所有用例：get_cases。
（c）步骤二中的所有返回值取并集。

3.2 获取测试任务

（a）获取Run任务详情
通过get_run接口获取该测试任务的详情，任务详情主要是对测试详情的概览，最终可以的如下图所示的总结。

如果想要该任务下的详细信息，可以通过 get_tests 来得到测试用例执行列表。

（b）获取Plan下的子任务详情
TestRail中，除了可以使用run以外，还可以添加Plan（推荐使用），在plan内添加子任务。任务详情内容就要通过 get_plan 来 获取。

4、小结

基于Testrail已有的功能上，我们通过API可以实现更多更有趣的功能，譬如在开发自动化测试脚本过程中，我们的测试结果若要实时反馈到TestRail中，便需要使用 add_result_for_case 接口，若要统计项目内所有测试用例的分布（用例等级、作者、时间区间、类型等），也需要借助 get_cases 接口获取原始数据进而二次开发。

TestRail的API接口为测试用例的功能扩展带来了很大的便利，大家可以在日常使用中，不断提出诉求，进而不断优化TestRail的不足。

—— 更多文章 ——

• 测试用例管理系统 TestRail测试用例
• 测试用例管理系统 Testrail 简介