如何通过TestRail API获取单次测试运行中超过250条的测试用例列表

TestRail的get_tests接口默认单次最多返回250条实体，可通过分页调用的方式获取全量测试用例，操作步骤如下：

• 调用接口时传入limit和offset两个分页控制参数：
  • limit：单次请求返回的最大条目数，最大值为250
  • offset：返回结果的偏移量，用于跳过已拉取的条目，默认值为0
• 循环调用接口，每次请求完成后将offset累加limit的数值，直到单次请求返回的条目数小于limit，即代表已拉取完该测试运行下的所有测试用例

可参考以下伪代码实现逻辑：

def get_all_tests_by_run_id(run_id):
    all_test_cases = []
    offset = 0
    page_size = 250  # 接口支持的最大单页返回量

    while True:
        # 调用get_tests接口，传入测试运行ID、分页参数
        response = testrail_client.get(
            f"get_tests/{run_id}",
            params={"limit": page_size, "offset": offset}
        )
        current_page_cases = response.get("tests", [])
        all_test_cases.extend(current_page_cases)

        # 单页返回量小于设置的页大小，说明没有更多数据
        if len(current_page_cases) < page_size:
            break
        offset += page_size
    
    return all_test_cases

提示：如果使用的是旧版本TestRail，需确认分页参数的传递方式，部分旧版本要求将参数放在POST请求体中提交。

内容的提问来源于stack exchange，提问作者Stephen