查询抄送列表 - 简道云

查询抄送列表调试

1. 简介

1.1 接口简介

该插件用于查询抄送列表，目前仅支持查询 90 天内的抄送数据。

1.2 接口版本

接口版本	更新时间	版本说明
V1	2025.07.22	原始接口

2. 接口调用

该插件用于查询抄送列表。

请求地址：https://api.jiandaoyun.com/api/v1/workflow/cc/list

请求频率：5 次/秒

请求方式：POST

请求参数:

参数	必须	类型	说明
username	是	string	用户名，即成员编号
skip	否	number	分页参数，跳过前面数据条数默认 0
limit	否	number	分页参数页大小默认 10，最大 100
read_status	否	string	已读状态，已读：“read” 未读：“unread” 全部：“all”（默认）

请求示例：

{
    "username":"xiaoyun",
    "skip": 0,
    "limit": 1,
    "read_status": "all"
}

响应参数：

参数	类型	说明
has_more	boolean	后面是否还有数据
cc_list	object[]	抄送列表注：仅支持查询 90 天内的抄送数据
cc_list[].app_id	string	应用 ID
cc_list[].form_id	string	表单 ID
cc_list[].task_id	string	抄送 ID
cc_list[].instance_id	string	实例 ID，同数据 ID
cc_list[].form_title	string	表单名称
cc_list[].title	string	提醒标题（节点名称）
cc_list[].flow_id	number	节点 ID
cc_list[].flow_name	string	节点名称
cc_list[].url	string	抄送访问链接
cc_list[].assignee	object	抄送人（同成员实体结构）
cc_list[].creator	object	流程发起人（同成员实体结构）
cc_list[].create_time	Date	流程发起时间
cc_list[].status	number	状态 0：未读 1：已读
cc_list[].start_time	Date	提醒创建时间
cc_list[].start_action	string	创建提醒的流程动作
cc_list[].finish_time	Date	标记已读时间，仅 status 为 1 时存在

响应示例：

{
    "cc_list": [
        {
            "app_id": "67c1584ea70e38aa41a9b466",
            "form_id": "67c1649dfee1fc583c98be20",
            "task_id": "67c164a8fee1fc583c98be7f",
            "instance_id": "67c164a8fee1fc583c98be59",
            "form_title": "抄送全部已读",
            "title": "节点1",
            "flow_id": 1,
            "flow_name": "节点1",
            "url": "https://www.jiandaoyun.com/workflow/process_instance/67c164a8fee1fc583c98be59/task/67c164a8fee1fc583c98be7f",
            "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"
            },
            "create_time": "2025-02-28T07:24:24.321Z",
            "status": 1,
            "start_time": "2025-02-28T07:24:24.323Z",
            "finish_time": "2025-02-28T07:24:27.608Z",
            "start_action": "forward"
        }
    ],
    "has_more": true
}