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
/v1/workflow/instance/logs
该接口用来查询流程日志信息。
**请求地址:**https://api.jiandaoyun.com/api/v1/workflow/instance/logs
请求频率:30 次/秒
请求方式:POST
请求参数:
参数必须类型说明
instance_id是string实例 id,同 data_id
types是string[]返回的日志类型,可选项;审批意见:“comment”
limit否number分页参数页大小默认 100 ,最大 100
skip否number分页参数,跳过前面数据条数默认为 0
请求示例:
{
    "instance_id": "659cba93489a49c06f7d4281",
    "types": [
        "comment"
    ],
    "skip": 0,
    "limit": 10
}
响应参数:
参数类型说明
logsobject[]日志列表
logs[].flow_idnumber节点 ID
logs[].flow_namestring节点名称
logs[].create_actionstring创建待办的流程动作
logs[].create_timeDate待办开始时间
logs[].finish_actionstring完成待办的流程动作
logs[].finish_timeDate待办完成时间
logs[].commentstring审批意见内容
logs[].signatureobject审批意见手写签名
logs[].signature.urlstring审批意见手写签名URL,15 天有效期
logs[].attachmentsobject[]附件列表
logs[].attachments[].namestring附件文件名
logs[].attachments[].sizenumber附件文件大小
logs[].attachments[].mimestring附件文件类型
logs[].attachments[].urlstring附件文件URL,15 天有效期
logs[].operatorobject审批/操作人信息,同 成员实体结构
响应示例:
{
    "logs": [
        {
            "flow_id": 1,
            "flow_name": "必须手写签名",
            "create_time": "2024-01-09T03:16:35.447Z",
            "create_action": "forward",
            "finish_time": "2024-01-09T03:17:03.239Z",
            "finish_action": "forward",
            "operator": {
                "username": "xiaojian",
                "name": "小简",
                "departments": [
                    1
                ],
                "type": 0,
                "status": 1
            },
            "comment": "一条审批意见",
            "signature": {
                "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
            },
            "attachments": [
                {
                    "name": "WechatIMG21.jpeg",
                    "size": 74935,
                    "mime": "image/jpeg",
                    "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
                },
                {
                    "name": "6b2cc009-141d-44c4-b5fc-5d01667ee0f8.jpg",
                    "size": 33174,
                    "mime": "image/jpeg",
                    "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
                },
                {
                    "name": "24x24.png",
                    "size": 34281,
                    "mime": "image/png",
                    "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
                }
            ]
        }
    ]
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
instance_id
string 
必需
实例 id,同 data_id
types
array[string]
必需
返回的日志类型,可选项; 审批意见:“comment”
skip
integer  | null 
可选
分页参数,跳过前面数据条数 默认为 0
limit
integer  | null 
可选
分页参数 页大小默认 100 ,最大 100
示例
{
    "instance_id": "659cba93489a49c06f7d4281",
    "types": [
        "comment"
    ],
    "skip": 0,
    "limit": 10
}

示例代码

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/v1/workflow/instance/logs' \
--header 'Content-Type: application/json' \
--data-raw '{
    "instance_id": "659cba93489a49c06f7d4281",
    "types": [
        "comment"
    ],
    "skip": 0,
    "limit": 10
}'

返回响应

🟢200成功
application/json
Body
logs
array [object {10}] 
日志列表
必需
flow_id
integer 
节点 ID
可选
flow_name
string 
节点名称
可选
create_time
string 
待办开始时间
可选
create_action
string 
创建待办的流程动作
可选
finish_time
string 
待办完成时间
可选
finish_action
string 
完成待办的流程动作
可选
operator
object 
可选
审批/操作人信息,同 成员实体结构
comment
string 
审批意见内容
可选
signature
object 
审批意见手写签名
可选
attachments
array [object {4}] 
附件列表
可选
示例
{
    "logs": [
        {
            "flow_id": 1,
            "flow_name": "必须手写签名",
            "create_time": "2024-01-09T03:16:35.447Z",
            "create_action": "forward",
            "finish_time": "2024-01-09T03:17:03.239Z",
            "finish_action": "forward",
            "operator": {
                "username": "xiaojian",
                "name": "小简",
                "departments": [
                    1
                ],
                "type": 0,
                "status": 1
            },
            "comment": "一条审批意见",
            "signature": {
                "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
            },
            "attachments": [
                {
                    "name": "WechatIMG21.jpeg",
                    "size": 74935,
                    "mime": "image/jpeg",
                    "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
                },
                {
                    "name": "6b2cc009-141d-44c4-b5fc-5d01667ee0f8.jpg",
                    "size": 33174,
                    "mime": "image/jpeg",
                    "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
                },
                {
                    "name": "24x24.png",
                    "size": 34281,
                    "mime": "image/png",
                    "url": "https://files.jiandaoyun.com/FtMNaGofTPeLMFW5_5SCs8w2mX8h?e=1595347199&token=bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:iac5fKQqYDZkF1YyvJUm4YRDPzg="
                }
            ]
        }
    ]
}
上一页
流程待办转交
下一页
激活流程实例
Built with