jdy
  1. workflow
jdy
  • 开发指南
  • app
    • 用户应用查询接口
      POST
    • 用户表单查询接口
      POST
  • formdata
    • form
      • 表单字段查询接口V5
    • data
      • 查询单条数据接口
      • 查询多条数据接口
      • 新建单条数据接口
      • 新建多条数据接口
      • 修改单条数据接口
      • 修改多条数据接口
      • 删除单条数据接口
      • 删除多条数据接口
  • file
    • 获取文件上传凭证和上传地址接口
      POST
    • 文件上传接口
      POST
  • corp
    • user
      • 获取成员信息接口
      • 添加成员接口
      • 修改成员接口
      • 删除成员接口
      • 批量删除成员接口
      • 增量导入成员接口
    • department
      • (递归)获取部门成员接口
      • (递归)获取部门列表接口
      • 创建部门接口
      • 修改部门接口
      • 删除部门接口
      • 获取集成模式部门编号接口
      • 全量导入部门接口
    • role
      • 列出角色接口
      • 创建一个自建角色
      • 更新一个自建角色
      • 删除一个自建角色
      • 列出角色下的成员
      • 为自建角色批量添加成员
      • 为自建角色批量移除成员
    • role_group
      • 列出自建角色组
      • 创建自建角色组
      • 更新自建角色组
      • 删除自建角色组
    • guest
      • 列出我连接的企业
      • 列出我连接的企业的对接人
      • 获取我连接的企业对接人的详细信息
  • workflow
    • 获取单条流程表单数据的审批意见
      POST
    • 查询流程实例信息
      POST
    • 结束流程实例
      POST
    • 流程待办查询
      POST
    • 流程待办提交
      POST
    • 流程待办回退
      POST
    • 流程待办转交
      POST
    • 查询流程日志
      POST
    • 激活流程实例
      POST
  1. workflow

流程待办查询

POST
/v3/workflow/task/list

接口调用#

该接口用来获取用户当前待办信息。
**请求地址:**https://api.jiandaoyun.com/api/v3/workflow/task/list
请求频率:30 次/秒
请求方式:POST
请求参数:
参数必须类型说明
username是String用户名
limit否Number分页参数,页大小 默认 10 最大 100
skip否Number分页参数,跳过前面数据条数 默认 0
请求示例:
{
    "username": "xiaoyun",
    "skip": 0,
    "limit": 10
}
响应参数:
参数类型说明
has_moreBoolean后面是否还有数据
tasksObject[]待办列表
tasks[].app_idString应用 id
tasks[].form_idString表单 id
tasks[].task_idString待办 id
tasks[].instance_idObject[]实例 id,同 data_id
tasks[].form_titleString表单名称
tasks[].titleString待办名称
tasks[].flow_idNumber节点 id
tasks[].flow_nameString节点名称
tasks[].urlString待办访问链接
tasks[].assigneeObject待办人信息同 成员实体结构
tasks[].creatorObject待办创建者信息同 成员实体结构
响应示例:
{
    "has_more": false,
    "tasks": [
        {
            "app_id": "628d8c0d73544c0006a54bfd",
            "task_id": "63f31ae8144f4a09ec197163",
            "form_id": "63ff33531c2f7e5fe8789b4b",
            "instance_id": "628d8c0d73544c0006a54bfc",
            "form_title": "物品申领",
            "title": "待办标题",
            "flow_id": 3,
            "flow_name": "行政审批",
            "url": "",
            "assignee": {
                "username": "xiaoyun",
                "name": "小云",
                "departments": [
                    1,
                    3
                ],
                "type": 0,
                "status": 1,
                "integrate_id": "xiaoyun"
            },
            "creator": {
                "username": "xiaojian",
                "name": "小简",
                "departments": [
                    1,
                    3
                ],
                "type": 0,
                "status": 1,
                "integrate_id": "xiaojian"
            }
        }
    ]
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
username
string 
用户名
必需
skip
integer 
可选
分页参数,页大小 默认 10 最大 100
limit
integer 
可选
分页参数,跳过前面数据条数 默认 0
示例
{
    "username": "string",
    "skip": 0,
    "limit": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.jiandaoyun.com/api/v3/workflow/task/list' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "string",
    "skip": 0,
    "limit": 0
}'

返回响应

🟢200成功
application/json
Body
has_more
boolean 
后面是否还有数据
必需
tasks
array [object {11}] 
待办列表
必需
app_id
string 
应用 id
可选
form_id
string 
表单 id
可选
task_id
string 
待办 id
可选
instance_id
string 
可选
实例 id,同 data_id
form_title
string 
表单名称
可选
title
string 
待办名称
可选
flow_id
number 
节点 id
可选
flow_name
string 
节点名称
可选
url
string 
待办访问链接
可选
assignee
object 
可选
待办人信息同 成员实体结构
creator
object 
可选
待办人信息同 成员实体结构
示例
{
    "has_more": false,
    "tasks": [
        {
            "app_id": "628d8c0d73544c0006a54bfd",
            "task_id": "63f31ae8144f4a09ec197163",
            "form_id": "63ff33531c2f7e5fe8789b4b",
            "instance_id": "628d8c0d73544c0006a54bfc",
            "form_title": "物品申领",
            "title": "待办标题",
            "flow_id": 3,
            "flow_name": "行政审批",
            "url": "",
            "assignee": {
                "username": "xiaoyun",
                "name": "小云",
                "departments": [
                    1,
                    3
                ],
                "type": 0,
                "status": 1,
                "integrate_id": "xiaoyun"
            },
            "creator": {
                "username": "xiaojian",
                "name": "小简",
                "departments": [
                    1,
                    3
                ],
                "type": 0,
                "status": 1,
                "integrate_id": "xiaojian"
            }
        }
    ]
}
上一页
结束流程实例
下一页
流程待办提交
Built with