当前位置: 首页 > 测试知识 > TestRail API使用常用API端点速查
TestRail API使用常用API端点速查
2026-05-27 作者cwb 浏览次数102

常用API端点速查


测试用例相关


获取单个测试用例详情

方法/端点:GET get_case/{case_id}

请求示例:GET index.php?/api/v2/get_case/1


获取指定项目与套件下的所有用例

方法/端点:GET get_cases/{project_id}

请求示例:GET index.php?/api/v2/get_cases/1&suite_id=5


在指定分区下创建新测试用例

方法/端点:POST add_case/{section_id}

请求示例:POST index.php?/api/v2/add_case/3


测试运行相关


在指定项目下创建新的测试运行

方法/端点:POST add_run/{project_id}

请求示例:POST index.php?/api/v2/add_run/12


获取指定ID的测试运行详情

方法/端点:GET get_run/{run_id}

请求示例:GET index.php?/api/v2/get_run/1


关闭一个测试运行

方法/端点:POST close_run/{run_id}

请求示例:POST index.php?/api/v2/close_run/1


测试结果相关


获取某个测试的所有结果

方法/端点:GET get_results/{test_id}

请求示例:GET index.php?/api/v2/get_results/100


为指定运行添加单个测试结果

方法/端点:POST add_result_for_case/{run_id}/{case_id}

请求示例:POST index.php?/api/v2/add_result_for_case/1/100


批量为运行添加多个测试结果

方法/端点:POST add_results_for_cases/{run_id}

请求示例:POST index.php?/api/v2/add_results_for_cases/1

附件相关


为测试结果添加附件(如截图)

方法/端点:POST add_attachment_to_result/{result_id}

请求示例:POST index.php?/api/v2/add_attachment_to_result/1


提示:{project_id} 等占位符,请替换为实例中的实际ID。关于各接口更详细的请求体(JSON Body)参数,请查阅官方 API 文档。


文章标签: API测试 软件测试 测试工具
咨询软件测试