pingcode logo
功能日记

REST API v1.17.0:开放Testhub的类型和模块资源


主要更新内容:

  1. 开放Testhub的类型和模块资源
  2. 获取测试用例时,增加自定义属性、类型和模块
  3. 获取工作项时,在工作项中增加完成时间属性
  4. 创建运行用例时支持指定执行人

开放Testhub的类型和模块资源

查看测试类型
GET /testhub/types/{type_id}

查看测试模块
GET /testhub/libraries/{library_id}/suites/{suite_id}

目前测试类型和测试模块是只读资源,相关的创建和修改操作需要在PingCode网页中完成。指的注意的是,在测试模块中包含一个“路径(paths)”属性,通过这个属性可以得到该模块的层级。

{
    "id": "{id}",
    "url": "https://rest_api_root/v1/testhub/libraries/{id}/suites/{id}",
    "library": {
        "id": "{id}",
        "url": "https://rest_api_root/v1/testhub/libraries/{id}",
        "name": "测试库"
    },
    "name": "登录",
    "paths": "首页/登录与注册"
}

获取测试用例时增加自定义属性、类型和模块

如下示例:

{
    "id": "{id}",
    "url": "https://rest_api_root/v1/testhub/cases/{id}",
    ......
    "suite": {
        "id": "{id}",
        "url": "https://rest_api_root/v1/testhub/libraries/{id}/suites/{id}",
        "name": "登录",
        "paths": "首页/登录与注册"
    },
    "type": {
        "id": "{id}",
        "url": "https://rest_api_root/v1/testhub/types/{id}",
        "name": "功能测试"
    },
    "properties": {
        "prop_a": "prop_a_value",
        "prop_b": "prop_b_value"
    }
}

获取工作项时,增加完成时间属性

这里的“完成时间”不是“截至时间”,而是当工作项状态设置为完成阶段的状态时,系统自动设置一个时间。

示例数据如下:

{
    "id": "{id}",
    "url": "https://rest_api_root/v1/agile/work_items/{id}",
    ......
    "completed_at": 1583290347
}

创建运行用例时支持指定执行人

在向测试计划中添加一个测试用例时,可以同时设置这个自动创建的运行用例的执行人,请求方式如下:

POST https://rest_api_root/v1/testhub/libraries/{id}/plans/{id}/runs
{
    "case_id": "{id}",
    "executor_id": "{id}"
}

创建之后,在测试计划列表中打开运行用例时,即可看到初始化的执行人:

更多功能请查看REST API 官方文档