飞书创建飞书审批API接口文档
创建飞书审批
接口地址:/open-apis/approval/v4/instances
请求方法: POST
加工厂: {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | approval_code | 新增审批code | string | 933C439B-9A77-458C-9FCB-9DF6F178A989 | 新增审批code | 否 |
| 2 | user_id | 发起人id | string | edc12944 | 否 | |
| 3 | form_1 | 文本 | object | jkbjb | 否 | |
| 3.1 | id | 控件 | string | widget1 | 否 | |
| 3.2 | type | 控件类型 | string | input | 否 | |
| 3.3 | value | 值 | string | data | 否 | |
| 4 | form_2 | 数字 | object | hjkbkb | 否 | |
| 4.1 | id | id | string | widget2 | 否 | |
| 4.2 | type | type | string | number | 否 | |
| 4.3 | value | value | string | 1234.5678 | 否 | |
| 5 | form_3 | 电话 | object | 否 | ||
| 5.1 | id | id | string | widget3 | 否 | |
| 5.2 | type | type | string | telephone | 否 | |
| 5.3 | value | value | string | 123 | 否 | |
| 5.4 | countryCode | 国家代码 | string | +86 | 否 | |
| 5.5 | nationalNumber | 手机号 | string | 13122222222 | 否 | |
| 6 | form_4 | 联系人 | object | 否 | ||
| 6.1 | id | id | string | widget4 | 否 | |
| 6.2 | type | type | string | contact | 否 | |
| 6.3 | value | value | string | edc12944 | 必须开启解析器, 传user_id, 多个值用 , 隔开 | 否 |
| 7 | form_5 | 部门 | object | 否 | ||
| 7.1 | id | id | string | widget6 | 否 | |
| 7.2 | type | type | string | department | 否 | |
| 7.3 | value | value | string | od-3ecad62f638b0ca43bf6ab417370b62a,od-3ecad62f638b0ca43bf6ab417370b62a | 必须开启解析器, 传open_department_id, 多个值用 , 隔开 | 否 |
| 8 | form_6 | 时间区间 | object | 否 | ||
| 8.1 | id | id | string | widget8 | 否 | |
| 8.2 | type | type | string | dateInterval | 否 | |
| 8.3 | value | value | string | 否 | ||
| 8.4 | start | 开始时间 | string | 2023-03-10 05:40:00 | 长日期格式 | 否 |
| 8.5 | end | 结束时间 | string | 2023-12-10 05:40:00 | 长日期格式 | 否 |
| 8.6 | interval | interval | string | 1.0 | 固定1.0 | 否 |
| 9 | form_7 | 明细1 | object | 明细1 | 否 | |
| 9.1 | id | id | string | widget5 | 否 | |
| 9.2 | type | type | string | fieldList | 否 | |
| 9.3 | value1-1 | value1-1 | array | widget16733174945100001 | 明细1的第一页, 必须配置来源数据的数组键值 | 否 |
| 9.3.1 | 明细1-1-1 | 明细1-1-1 | object | 明细1的第一页的控件1 | 否 | |
| 9.3.1.1 | id | id | string | widget51 | 否 | |
| 9.3.1.2 | type | type | string | input | 否 | |
| 9.3.1.3 | value | value | string | {{name}} | 否 | |
| 9.3.2 | 明细1-1-2 | 明细1-1-2 | object | 明细1的第一页的控件2 | 否 | |
| 9.3.2.1 | id | id | string | widget52 | 否 | |
| 9.3.2.2 | type | type | string | input | 否 | |
| 9.3.2.3 | value | value | string | cesces | 否 | |
| 9.4 | value1-2 | value1-2 | array | widget16733174945100001 | 明细1的第二页, 必须配置来源数据的数组键值 | 否 |
| 9.4.1 | 明细1-2-1 | 明细1-2-1 | object | 明细1的第二页的控件1 | 否 | |
| 9.4.1.1 | id | type | string | widget51 | 否 | |
| 9.4.1.2 | type | type | string | input | 否 | |
| 9.4.1.3 | value | value | string | {{name}} | 否 | |
| 9.4.2 | 明细1-2-2 | 明细1-2-2 | object | 明细1的第二页的控件2 | 否 | |
| 9.4.2.1 | id | id | string | widget52 | 否 | |
| 9.4.2.2 | type | type | string | input | 否 | |
| 9.4.2.3 | value | value | string | {{name}} | 否 | |
| 10 | form_8 | 明细2 | object | 明细2 | 否 | |
| 10.1 | id | id | string | widget9 | 否 | |
| 10.2 | type | type | string | fieldList | 否 | |
| 10.3 | value2-1 | value2-1 | array | widget16733174975890001 | 明细2的第一页, 必须配置来源数据的数组键值 | 否 |
| 10.3.1 | 明细2-1-1 | 明细2-1-1 | object | 否 | ||
| 10.3.1.1 | id | id | string | widget91 | 否 | |
| 10.3.1.2 | type | type | string | input | 否 | |
| 10.3.1.3 | value | value | string | 123 | 否 | |
| 11 | form_9 | 附件 | object | 否 | ||
| 11.1 | id | id | string | widget12 | 否 | |
| 11.2 | type | type | string | attachmentV2 | 否 | |
| 11.3 | value1 | 附件1 | array | widget16733174945100001 | 否 | |
| 11.3.1 | fileName | 文件名称 | string | 测试文件.txt | 否 | |
| 11.3.2 | filePath | 下载路径 | string | /www/wwwroot/service/public/uploadFile/2023-1-4/vue-color-avatar1.png | 否 | |
| 12 | form_10 | 图片 | object | widget16733174945100001 | 否 | |
| 12.1 | id | id | string | widget11 | 否 | |
| 12.2 | type | type | string | image | 否 | |
| 12.3 | value1 | 图片1 | array | widget16733174945100001 | 否 | |
| 12.3.1 | fileName | 文件名称 | string | 测试图片.png | 否 | |
| 12.3.2 | filePath | 文件路径 | string | /www/wwwroot/service/public/uploadFile/2023-1-4/vue-color-avatar1.png | 否 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|
飞书的接口:创建飞书审批(/open-apis/approval/v4/instances),由轻易云数据集成平台API资产管理模块整理收纳,并且根据飞书版本更新同步实时更新。通过API资产管理,企业可以对API的使用情况进行详细的分析和报告,为业务决策提供数据支持,优化资源分配和投资回报。
