更新时间:2022-12-08 GMT+08:00

获取工作项历史记录

功能介绍

获取工作项历史记录

URI

GET /v4/projects/{project_id}/issue/{issue_id}/records

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

devcloud项目的32位id

最小长度:32

最大长度:32

issue_id

Integer

工作项id

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

分页索引,偏移量,offset是limit的整数倍,limit=10,offset=0,10,20...

最小值:0

缺省值:0

limit

Integer

每页显示的数量,每页最多显示100条

最小值:1

最大值:1000

缺省值:10

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:10

最大长度:32768

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

id

Integer

操作记录id (已废弃)

created_time

Long

创建时间 (已废弃)

records

Array of IssueRecordV4 objects

历史记录

total

Integer

操作记录总数

表5 IssueRecordV4

参数

参数类型

描述

id

Integer

操作记录id

created_time

Long

操作记录创建时间

user

user object

工作项操作的用户

details

Array of details objects

操作的记录

表6 user

参数

参数类型

描述

user_num_id

Integer

用户数字id

user_name

String

登录名

nick_name

String

昵称

user_id

String

用户32位的uuid

表7 details

参数

参数类型

描述

property

String

操作属性

old_value

String

上次的记录

new_value

String

当前值

operation

String

操作

id

Integer

操作记录的id

name

String

操作的字段

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 401

表9 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

Get https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/issue/3458/records

Get https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/issue/3458/records

响应示例

状态码: 200

OK

{
  "id" : 1221,
  "created_time" : "1597116605000",
  "records" : [ {
    "id" : 1234,
    "created_time" : 1617764919000,
    "user" : {
      "user_num_id" : 4091,
      "user_name" : "demo_user_name",
      "nick_name" : "aaa",
      "user_id" : "a360371833bf4c558f796fd707b44daf"
    },
    "details" : [ {
      "property" : 1,
      "old_value" : 1,
      "new_value" : 2,
      "operation" : "批量编辑",
      "id" : 3597,
      "name" : "标题"
    } ]
  } ],
  "total" : 1
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码