文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 外部服务管理/ 查询某测试计划下的操作历史 - ShowIteratorHistories
更新时间:2025-12-27 GMT+08:00
分享

查询某测试计划下的操作历史 - ShowIteratorHistories

功能介绍

此接口用于查询指定测试计划下的操作历史,包含测试计划添加/删除用例的操作历史记录,变更描述的操作历史记录等操作历史数据

调用方法

请参见如何调用API

URI

GET /v4/testhub/projects/{project_id}/iterators/{iterator_uri}/histories

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

iterator_uri

String

计划uri

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

当前页数

limit

Integer

每页条数

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

success|error

error

ApiError object

错误信息

request_id

String

由接口调用方传入,建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址

result

Object

status为failed时,存放只有reason的ApiError对象

表4 ApiError

参数

参数类型

描述

code

String

业务失败的错误编码

reason

String

业务失败的提示内容

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

请求示例

get https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/iterators/s32sadg553/histories?offset=1&limit=10

响应示例

状态码:200

OK

[ {
  "project_id" : "1b7179edc79a431f9711434124ac9f28",
  "detail" : {
    "journalized_type" : "plan",
    "deleted" : [ ],
    "added" : [ {
      "name" : "SF01",
      "id" : "1185878300068290560"
    }, {
      "name" : "IR002",
      "id" : "1185878603530375169"
    } ],
    "type" : "issue",
    "updated" : [ ]
  },
  "operator" : {
    "name" : "222",
    "id" : "a17801c5d15f46e28112eec8a880683d"
  },
  "plan_id" : "v90200010s4auo7d",
  "operate_time" : "2025-10-18 15:11:47"
} ]

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档