玩转搭贝
表单管理
表单设计
流程设计
流程设计
流程常见问题
仪表盘
基础图表
自定义组件
常见问题FAQ
列表相关FAQ
业务规则FAQ
数据导入FAQ
更新日志
场景解决方案
人事/绩效
行政/资产
销售/客户
项目/任务/工单
物业/园区
进销存/仓储
商管/租赁
法律业务
行业解决方案
制造业/工业生产
- 搭贝学院
- 开放接口
- 修改数据
修改数据
发布人：爱搭贝
更新时间：2026-05-19
5.1、修改数据
接口地址：/apps/{app_id}/forms/{form_id}/record_update 请求方式：POST
请求参数
| 参数 | 类型 | 必输 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户id |
| record_id | string | 是 | 记录id(查询列表里返回值的id) |
样例：
{
"user_id":"5f2fda02ea674ee0a5143b87b81af5e2", //用户id
"record_id":"fdfdfda02ea674ee0a5143b87b81af5e2",//记录id
"xxx_input_xxx":"123"//表单对应字段
}5.2、流程提交
接口地址：/apps/{app_id}/forms/{form_id}/records/{record_id}/tasks/{task_id}/submit 请求方式：POST
请求参数
| 参数 | 类型 | 必输 | 说明 |
|---|---|---|---|
| form_id | string | 是 | 表单id |
| app_id | string | 是 | 应用id |
| record_id | string | 是 | 记录id(查询列表里返回值的id) |
| task_id | string | 是 | 任务id(查询待办列表里返回值的taskId) |
| submitReq | object | 是 | 要提交的任务,requestBody |
| submitReq.userId | string | 是 | 提交人的id |
| submitReq.approve.content | string | 否 | 提交的审批信息 |
| submitReq.approve.variables | string | 是 | 当前表单的变量值 |
样例：
{
// body体里只需要denyReq的请求参数
"userId":"b76d5c1f9c36449f8f3f08ab0207765b",
"approve":{
"content":"同意",
"attachments":["https://xxxxxxx/附件.pdf"],
"images":["https://xxxxxxx/图片.png"],
},
"variables":{
"组件key":"组件value"
}
}5.3、流程拒绝
接口地址：/apps/{app_id}/forms/{form_id}/records/{record_id}/tasks/{task_id}/deny 请求方式：POST
请求参数
- 注：除了uri外，这个参与与流程是完全一样的
| 参数 | 类型 | 必输 | 说明 |
|---|---|---|---|
| form_id | string | 是 | 表单id |
| app_id | string | 是 | 应用id |
| record_id | string | 是 | 记录id(查询列表里返回值的id) |
| task_id | string | 是 | 任务id(查询待办列表里返回值的taskId) |
| denyReq | object | 是 | 要提交的任务,requestBody |
| denyReq.userId | string | 是 | 提交人的id |
| denyReq.approve.content | string | 否 | 拒绝的审批信息 |
| denyReq.variables | string | 是 | 当前表单的变量值 |
样例：
{
// body体里只需要denyReq的请求参数
"userId":"b76d5c1f9c36449f8f3f08ab0207765b",
"approve":{
"content":"同意",
"attachments":["https://xxxxxxx/附件.pdf"],
"images":["https://xxxxxxx/图片.png"],
},
"variables":{
"组件key":"组件value"
}
}
5.4、流程转办
接口地址：/apps/{app_id}/forms/{form_id}/records/{record_id}/tasks/{task_id}/transfer 请求方式：POST
请求参数
| 参数 | 类型 | 必输 | 说明 |
|---|---|---|---|
| form_id | string | 是 | 表单id |
| app_id | string | 是 | 应用id |
| record_id | string | 是 | 记录id(查询列表里返回值的id) |
| task_id | string | 是 | 任务id(查询待办列表里返回值的taskId) |
| transferReq | object | 是 | 要提交的任务,requestBody |
| transferReq.userId | string | 是 | 提交人的id |
| transferReq.approve.content | string | 否 | 转换的审批信息 |
| transferReq.transferIds | array | 是 | 要转换给的人员id集合 |
样例：
{
// body体里只需要transferReq的请求参数
"userId":"b76d5c1f9c36449f8f3f08ab0207765b",
"approve":{
"content":"请协助审批",
"attachments":["https://xxxxxxx/附件.pdf"],
"images":["https://xxxxxxx/图片.png"],
},
"transferIds":["6c039a0c1da74ea4bba3066683735b49"]
}5.4、流程撤销
接口地址：/apps/{app_id}/forms/{form_id}/records/{record_id}/cancel?user_id= 请求方式：POST
请求参数
| 参数 | 类型 | 必输 | 说明 |
|---|---|---|---|
| form_id | string | 是 | 表单id |
| app_id | string | 是 | 应用id |
| record_id | string | 是 | 记录id(查询列表里返回值的id) |
| user_id | string | 是 | 操作人信息，只有操作人为发起人才可以撤销成功 |
样例：
{
"form_id":"684ad97c537b47df824a8b602411b2d2",//路径里带着呢body体不需要传
"app_id": "35af7f00c69e44198f894378c68b2a58",//路径里带着呢body体不需要传
"task_id":"5f2fda02ea674ee0a5143b87b81af5e2",//路径里带着呢body体不需要传
"record_id":"8d50102b87634d41b2614c35229dd4b5",//路径里带着呢body体不需要传
"user_id":"string" //路径里带着呢body体不需要传,带到路径里都是需要加签的 这里注意key按是按自然排序的
}本篇目录
{{ dl1.name }}
{{ dl2.name }}
{{ dl3.name }}