飞书开放平台 Server API 文档

主题

获取流程数据 ​

根据流程实例 id（process_id）获取流程字段数据，包括业务字段和自定义字段，还有流程的数据（比如流程发起人、发起时间等），仅支持飞书人事、假勤相关业务流程。

Tip: 此接口只返回流程数据列表里的字段信息，对于流程数据的关联数据，如员工的部门、入职日期等，需调用各自领域的接口去查询。例如，只返回异动员工是谁，员工的其他信息需通过人员接口查询。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/corehr/v2/processes/:process_id/flow_variable_data
HTTP MethodGET
接口频率限制10 次/分钟
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用corehr:process:read 获取流程数据
字段权限要求> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

路径参数 ​

名称类型描述
process_idstring流程实例ID。可通过查询流程实例列表接口获取
示例值："7341373094948242956"

查询参数 ​

名称类型必填描述
user_id_typestring否用户 ID 类型
示例值：people_corehr_id
可选值有：
- open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_corehr_id: 以飞书人事的 ID 来识别用户
默认值：people_corehr_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_typestring否此次调用中使用的部门 ID 类型
示例值：people_corehr_department_id
可选值有：
- open_department_id: 以 open_department_id 来标识部门 - department_id: 以 department_id 来标识部门 - people_corehr_department_id: 以 department_id 来标识部门
默认值：people_corehr_department_id
variable_keysstring\[\]否需要查询变量key
示例值：changer

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ field_variable_valuesfield_variable_value\[\]流程数据
    └ variable_api_namestring变量唯一标识
    └ variable_namefield_variable_value_i18n变量名称，在查询流程数据场景不会返回变量名称
      └ zh_cnstring中文值
      └ en_usstring英文值
    └ variable_valuefield_variable_value_to变量值
      └ text_valuestring文本值
      └ bool_valueboolean布尔值
      └ number_valuestring数字值
      └ enum_valuestring枚举值，这里是枚举的id
      └ date_valuestring从 1970 开始的天数
      └ date_time_valuestring时间戳，毫秒
      └ i18n_valuefield_variable_value_i18n多语字段值
        └ zh_cnstring中文值
        └ en_usstring英文值
      └ object_valuefield_variable_value_to_object对象值，包括对象id和对象类型
        └ wk_idstringwukong的对象唯一标识
        └ wk_api_namestringwukong的元数据唯一标识
      └ user_valuestring用户id，根据user_type选择对应的用户id
      └ department_valuestring部门id，根据入参选择对应的部门id
      └ record_valuesfield_variable_value_to_record\[\]记录类型字段值
        └ variable_api_namestring变量唯一标识
        └ sub_value_keystring变量值，对应subValues中的key
        └ record_idstring记录唯一ID
      └ employment_valuestring员工类型字段值，为用户id，根据入参选择返回的用户id
      └ list_valuesstring\[\]数组类型值，里面包含多个值，每个元素都对应subValues中的数组下标
      └ file_valuefield_variable_value_to_file文件类型字段值，可通过主数据的文件下载Open API下载
        └ open_file_idstring用于主数据文件下载接口的id
        └ file_namestring文件名称
        └ lengthint文件大小，单位：Byte
        └ mime_typestring文件类型，如application/pdf
    └ sub_valuesfield_variable_sub_vlaue\[\]在list_values和record_values中引用的变量
      └ keystring用于关联list和record类型变量值中的key
      └ valuefield_variable_value_to变量值
        └ text_valuestring文本值
        └ bool_valueboolean布尔值
        └ number_valuestring数字值
        └ enum_valuestring枚举值，这里是枚举的id
        └ date_valuestring从 1970 开始的天数
        └ date_time_valuestring时间戳，毫秒
        └ i18n_valuefield_variable_value_i18n多语字段值
          └ zh_cnstring中文值
          └ en_usstring英文值
        └ object_valuefield_variable_value_to_object对象值，包括对象id和对象类型
          └ wk_idstringwukong的对象唯一标识
          └ wk_api_namestringwukong的元数据唯一标识
        └ user_valuestring用户id，根据user_type选择对应的用户id
        └ department_valuestring部门id，根据入参选择对应的部门id
        └ record_valuesfield_variable_value_to_record\[\]记录类型字段值
          └ variable_api_namestring变量唯一标识
          └ sub_value_keystring变量值，对应subValues中的key
          └ record_idstring记录唯一ID
        └ employment_valuestring员工类型字段值，为用户id，根据入参选择返回的用户id
        └ list_valuesstring\[\]数组类型值，里面包含多个值，每个元素都对应subValues中的数组下标
        └ file_valuefield_variable_value_to_file文件类型字段值，可通过主数据的文件下载Open API下载
          └ open_file_idstring用于主数据文件下载接口的id
          └ file_namestring文件名称
          └ lengthint文件大小，单位：Byte
          └ mime_typestring文件类型，如application/pdf
  └ process_idstring流程实例id

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "field_variable_values": [
            {
                "variable_api_name": "custom123",
                "variable_name": {
                    "zh_cn": "北京",
                    "en_us": "Beijing"
                },
                "variable_value": {
                    "text_value": "测试测试",
                    "bool_value": true,
                    "number_value": "100",
                    "enum_value": "home_address",
                    "date_value": "19838",
                    "date_time_value": "1714013877512",
                    "i18n_value": {
                        "zh_cn": "北京",
                        "en_us": "Beijing"
                    },
                    "object_value": {
                        "wk_id": "6863326263210149383",
                        "wk_api_name": "country_region_subdivision"
                    },
                    "user_value": "ou_c57053dad6eea0aea4696c48433d8562",
                    "department_value": "od-a761814f6bc3f14bd3b00905ec1d7c6f",
                    "record_values": [
                        {
                            "variable_api_name": "city_v2",
                            "sub_value_key": "key1",
                            "record_id": "6863326263210149383"
                        }
                    ],
                    "employment_value": "ou_c57053dad6eea0aea4696c48433d8562",
                    "list_values": [
                        "key1"
                    ],
                    "file_value": {
                        "open_file_id": "66867ed00740ddd4a0bad4a5_c99b5322dc744fe4b99b76426ffe5d53",
                        "file_name": "file_name",
                        "length": 65535,
                        "mime_type": "application/pdf"
                    }
                },
                "sub_values": [
                    {
                        "key": "key1",
                        "value": {
                            "text_value": "测试测试",
                            "bool_value": true,
                            "number_value": "100",
                            "enum_value": "home_address",
                            "date_value": "19838",
                            "date_time_value": "1714013877512",
                            "i18n_value": {
                                "zh_cn": "北京",
                                "en_us": "Beijing"
                            },
                            "object_value": {
                                "wk_id": "6863326263210149383",
                                "wk_api_name": "country_region_subdivision"
                            },
                            "user_value": "ou_c57053dad6eea0aea4696c48433d8562",
                            "department_value": "od-a761814f6bc3f14bd3b00905ec1d7c6f",
                            "record_values": [
                                {
                                    "variable_api_name": "city_v2",
                                    "sub_value_key": "key1",
                                    "record_id": "6863326263210149383"
                                }
                            ],
                            "employment_value": "ou_c57053dad6eea0aea4696c48433d8562",
                            "list_values": [
                                "key1"
                            ],
                            "file_value": {
                                "open_file_id": "66867ed00740ddd4a0bad4a5_c99b5322dc744fe4b99b76426ffe5d53",
                                "file_name": "file_name",
                                "length": 65535,
                                "mime_type": "application/pdf"
                            }
                        }
                    }
                ]
            }
        ],
        "process_id": "7368832822481536556"
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
4001160100Process is not found确认审批流程ID是否存在
5001160500System error系统内部异常，请咨询技术支持协助排查。
4001160101param error参数错误，请操作接口字段说明自查
5001160102System error系统内部异常，请咨询技术支持协助排查。

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有