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

功能介绍

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

调用方法

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

[ {
  "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"
} ]