查询工作项变更日志

POST 
/project/issueFields/changeLog/query

从 issue_version 查询工作项变更日志，并按工作项分组、按工作项分页返回。

关键语义：

• create_time、update_time 过滤的是工作项字段，不是 issue_version 字段。
• 分页对象是工作项（cursor + limit）。
• limit 默认 50，最大 1000。
• 返回的变更记录总量上限为 10000，超限时 records_truncated = true。

Request

Query Parameters

teamID stringrequired

团队ID

application/json

Body

project_uuids string[]

项目 UUID 列表，可空。为空表示查询所有项目。

issue_uuids string[]required

Possible values: >= 1, <= 1000

工作项 UUID 列表，必填。至少传 1 个，最多传 1000 个。

field_uuids string[]

字段 UUID 列表，可空。为空表示返回所有发生变更的字段。

limit integer

Possible values: >= 1 and <= 1000

工作项分页大小。默认 50，最大 1000。

cursor string

工作项分页游标，首次请求传空字符串。

create_time

object

毫秒时间戳区间。

start int64

起始时间（包含），单位毫秒。

end int64

结束时间（包含），单位毫秒。

update_time

object

毫秒时间戳区间。

start int64

起始时间（包含），单位毫秒。

end int64

结束时间（包含），单位毫秒。

Responses

200

请求成功

application/json

Schema

Schema

data

object

required

records

object[]

required

Array [

issue_uuid string

name string

工作项名称。

records

object[]

Array [

version_uuid string

create_time int64

版本创建时间，单位毫秒。

field_uuid string

field_type string

field_name string

old_value

object

nullable

oneOf

MOD1

string

MOD2

integer

MOD3

number

MOD4

boolean

MOD6

object

new_value

object

nullable

oneOf

MOD1

string

MOD2

integer

MOD3

number

MOD4

boolean

MOD6

object

author

object

nullable

uuid string

name string

]

record_count integer

当前工作项下的变更记录数量。

]

page_info

object

has_next_page boolean

是否存在下一页工作项。

start_cursor string

当前页工作项起始游标。

end_cursor string

当前页工作项结束游标。

page_count integer

当前页工作项数量。

records_truncated booleanrequired

是否因为超过 10000 条上限而被截断。

record_count integerrequired

当前响应返回的变更记录总数。

Example (from schema)

{
  "data": {
    "records": [
      {
        "issue_uuid": "string",
        "name": "string",
        "records": [
          {
            "version_uuid": "string",
            "create_time": 0,
            "field_uuid": "string",
            "field_type": "string",
            "field_name": "string",
            "old_value": "string",
            "new_value": "string",
            "author": {
              "uuid": "string",
              "name": "string"
            }
          }
        ],
        "record_count": 0
      }
    ],
    "page_info": {
      "has_next_page": true,
      "start_cursor": "string",
      "end_cursor": "string",
      "page_count": 0
    },
    "records_truncated": true,
    "record_count": 0
  }
}

Example

{
  "data": {
    "records": [
      {
        "issue_uuid": "CwQKxDfF",
        "name": "更新后的工作项标题",
        "record_count": 2,
        "records": [
          {
            "version_uuid": "ver001",
            "create_time": 1737000000123,
            "field_uuid": "field001",
            "field_type": "text",
            "field_name": "标题",
            "old_value": "旧标题",
            "new_value": "新标题",
            "author": {
              "uuid": "user001",
              "name": "张三"
            }
          },
          {
            "version_uuid": "ver001",
            "create_time": 1737000000123,
            "field_uuid": "field005",
            "field_type": "status",
            "field_name": "状态",
            "old_value": "status_in_progress",
            "new_value": "status_done",
            "author": {
              "uuid": "user001",
              "name": "张三"
            }
          }
        ]
      }
    ],
    "page_info": {
      "has_next_page": true,
      "start_cursor": "0",
      "end_cursor": "50",
      "page_count": 50
    },
    "records_truncated": false,
    "record_count": 2
  }
}

401

如果身份验证凭据不正确或丢失，则返回

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Unauthorized",
  "errorMsg": "Access token is invalid"
}

403

如果scope检验不通过，则返回

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Forbidden",
  "errorMsg": "Scope is invalid"
}

404

如果未找到资源对象，则返回

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "NotFound",
  "errorMsg": "Not Found"
}

500

内部服务器错误

application/json

Schema

Schema

result string

本次请求结果,SUCCESS|FAIL

errorCode string

本次请求错误码

errorMsg string

本次请求错误信息

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Internal Server Error",
  "errorMsg": "Internal Server Error"
}

Loading...