查询IR历史记录
功能介绍
查询ir的历史记录。
调用方法
请参见如何调用API。
URI
GET /v4/irs/{ir_id}/histories
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ir_id |
是 |
String |
参数解释: IR的ID,可以通过查询工作项详情接口获取,响应消息体中的id字段的值就是IR的ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
否 |
Integer |
参数解释: 分页索引,偏移量,offset是limit的整数倍数。 约束限制: 正则表达式,0|[1-9]\d{0,10}。 取值范围: 最小值:0。 默认取值: 0 |
limit |
否 |
Integer |
参数解释: 每页显示查询IR历史记录的数量 约束限制: 不涉及 取值范围: 最小值:1 最大值:100 默认取值: 10 |
请求参数
无
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
histories |
Array of InitialRequirementHistory objects |
参数解释: 历史记录 |
total |
Integer |
参数解释: 总数 取值范围: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
created_time |
Long |
参数解释: 操作时间 取值范围: 不涉及 |
details |
Array of IrRecordDetail objects |
参数解释: 详细操作(该字段为包含0个或1个元素的数组,包含元素时,其内容表示对某个字段的操作) |
ir_id |
String |
参数解释: 历史记录所属IR的id 取值范围: 不涉及 |
operation_type |
String |
参数解释: 操作类型 取值范围: 不涉及 |
operator |
User object |
参数解释: 操作人员 |
参数 |
参数类型 |
描述 |
---|---|---|
field_id |
String |
参数解释: 操作的字段id。 取值范围: 不涉及。 |
field_label |
String |
参数解释: 字段名称。 取值范围: 不涉及。 |
new_value |
String |
参数解释: 修改后的值。 取值范围: 不涉及。 |
old_value |
String |
参数解释: 修改前的值。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
domain_id |
String |
参数解释: 租户uuid 取值范围: 不涉及 |
domain_name |
String |
参数解释: 租户名 取值范围: 不涉及 |
gender |
String |
参数解释: 性别 取值范围: 不涉及 |
nick_name |
String |
参数解释: 昵称 取值范围: 不涉及 |
user_id |
String |
参数解释: 用户uuid 取值范围: 不涉及 |
user_name |
String |
参数解释: 用户名 取值范围: 不涉及 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
GET /v4/irs/4647058403938004992/histories
响应示例
状态码:200
OK
{ "content" : [ { "id" : "4715591254868217856", "region" : "example", "operator" : { "label" : "xxxxxx", "name" : "xxxxxx", "id" : "xxxxxx", "nick_name" : "xxxxxx", "domain_id" : "xxxxxx", "domain_name" : "xxxxxx", "gender" : null }, "details" : [ { "type" : "SingleLineText", "field_id" : "1", "option_source" : "Text", "field_label" : "标题", "new_value" : "111", "new_object_id" : "111" } ], "created_on" : "1753774195785", "updated_on" : "1753774195785", "ir_id" : "4715591254831517696", "operation_type" : "新建", "group_id" : "4715591254867169280" } ], "pageable" : { "pageNumber" : 1, "pageSize" : 15, "sort" : { "unsorted" : false, "empty" : false, "sorted" : true }, "offset" : "15", "paged" : true, "unpaged" : false }, "offset" : "0", "last" : true, "first" : true, "size" : 15, "number" : 1, "sort" : { "unsorted" : false, "empty" : false, "sorted" : true }, "empty" : false, "total_pages" : 1, "total_elements" : "1", "stat" : null, "number_of_elements" : 1 }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
错误码
请参见错误码。