查询审批实例操作记录列表

适用版本>=v7.0.2511.20251120

接口说明： 分页查询审批实例操作记录列表

标签：审批实例

请求说明

字段	值
请求地址	配置域名+/openapi+/v7/workflow/approval_instances/batch_get_timeline
HTTP 方法	GET
接口描述	分页查询审批操作记录
签名方式	KSO-1（配置域名+/openapi不参与签名）
限频策略	无
权限要求	查询审批实例(应用授权) kso.workflow_approval_instance.read 操作审批实例(应用授权) kso.workflow_approval_instance.readwrite

请求头 (Headers)

属性名	类型	是否必填	描述	可选值
X-Kso-Id-Type	string	否	类型 * internal - 内部 * external - 外部	internal, external
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT	-
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》	-
Authorization	string	是	授权凭证，格式为：Bearer {access_token}	-

查询参数 (Query)

属性名	类型	是否必填	描述	可选值
page_size	integer	否	分页大小，取值范围10-50，默认为10	-
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果	-
approval_define_id	string	否	审批定义id，传入该值时查询指定审批定义的操作记录，审批定义id、审批单id、操作的执行人三者至少传一个	-
instance_id	string	否	审批单id，传入该值时查询指定审批单的操作记录，审批定义id、审批单id、操作的执行人三者至少传一个	-
time_from	string	否	任务查询开始时间，Unix 秒时间戳。与 time_to 参数构成时间段查询条件，仅会返回在该时间段内的审批实例。	-
time_to	string	否	任务查询结束时间，Unix 秒时间戳。与 time_from 参数构成时间段查询条件，仅会返回在该时间段内的审批实例。	-
operator	string	否	操作的执行人，不传时默认查本租户下的所有数据，审批定义id、审批单id、操作的执行人三者至少传一个	-
type	string	否	审批操作类型，不传默认查所有的。查多个时可用,隔开。可选值有：approval_created：发起审批, passed：审批同意, reject：审批拒绝, returned：审批退回, revoke：审批撤回, comment：审批评论, cc：审批抄送, create_group：创建群聊, add_sign：加签, deleted：删除审批实例, rollback：回滚审批实例, auto_passed：自动通过, transfer：转交, auto_approval：自动审批	-

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

{
  "data": {
    "has_more": true,
    "page_token": "string",
    "timeline_list": [
      {
        "instance": {
          "approval_define_id": "string",
          "id": "string",
          "serial_no": "string",
          "start_time": 0,
          "status": "auditing",
          "title": "string",
          "user_id": "string"
        },
        "time_line": {
          "comment": "string",
          "comment_attachments": {
            "attachments": [
              {}
            ],
            "images": [
              {}
            ],
            "signature": {}
          },
          "ctime": 0,
          "id": 0,
          "node_id": 0,
          "node_name": "string",
          "operator": "string",
          "type": "approval_created",
          "user_list": [
            "string"
          ]
        }
      }
    ]
  },
  "code": 0,
  "msg": "string"
}