查询审批任务列表

分页查询审批任务列表

标签：审批任务

请求说明

字段	值
请求地址	https://openapi.wps.cn/v7/workflow/approval_tasks/batch_get
HTTP 方法	GET
接口描述	分页查询审批任务列表
签名方式	KSO-1
限频策略	无
权限要求	操作审批任务(应用授权) kso.workflow_approval_task.readwrite

请求头 (Headers)

属性名	类型	是否必填	描述	可选值
X-Kso-Id-Type	string	否	类型 * internal - 内部 * external - 外部	internal, external

查询参数 (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 参数构成时间段查询条件，仅会返回在该时间段内的审批实例。	-
user_id	string	否	任务的执行人，不传时默认查本租户下的所有数据，审批定义id、审批单id、任务的执行人三者至少传一个	-
task_status	string	否	审批任务状态。若不设置则查询全部状态，若不在集合中，则报错。状态有：pending：审批中, approved：已审批, rejected：已拒绝, transferred：已转交, done：已完成, rollback：已回滚	pending, approved, rejected, transferred, done, rollback, review

响应体(Response)

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

没有可用的数据

响应体示例

{
  "data": {
    "has_more": true,
    "page_token": "string",
    "task_list": [
      {
        "instance": {
          "approval_define_id": "string",
          "id": "string",
          "serial_no": "string",
          "start_time": 0,
          "status": "auditing",
          "title": "string",
          "user_id": "string"
        },
        "task": {
          "approval_rule": "step",
          "end_time": "string",
          "id": "string",
          "node_id": "string",
          "start_time": "string",
          "status": "pending",
          "title": "string",
          "user_id": "string"
        }
      }
    ]
  },
  "code": 0,
  "msg": "string"
}