跳到主要内容

批量删除行记录

V1 列值协议;直接 HTTP 调用,需要用户 Bearer 和当前请求签名。

项目内容
方法POST
路径/open-api/openapi/form/batchDelete
认证用户 Bearer + 当前请求签名 + 租户与应用上下文
请求格式application/json

调用准备​

按公共请求约定替换地址和占位值,按生成签名计算本次请求的签名。以下 JSON 保存为 UTF-8 的 request.json;签名必须使用同一份实际参数。示例为命令行 cURL;Windows PowerShell 可使用 curl.exe 并将多行命令合为一行。

请求参数​

参数类型 / 必填说明
table字符串 / 是目标表单 ID;与当前应用归属一致。
conditions对象 / 是限定目标记录;使用 join / items / var / compare / values。

请求示例​

request.json
{
"table": "YOUR_FORM_ID",
"conditions": {
"join": "AND",
"items": [
{
"join": "OR",
"var": "id",
"compare": 10,
"values": [
"YOUR_RECORD_ID_A"
]
},
{
"join": "OR",
"var": "id",
"compare": 10,
"values": [
"YOUR_RECORD_ID_B"
]
}
]
}
}
curl --request POST "https://admin.duoge.work/api/open-api/openapi/form/batchDelete" \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--header "TENANT-ID: YOUR_NUMERIC_TENANT_ID" \
--header "X-APPLICATION-ID: YOUR_APPLICATION_ID" \
--header "app_id: YOUR_APPLICATION_ID" \
--header "timestamp: CURRENT_MILLISECONDS" \
--header "signature: SIGNATURE_FOR_THIS_REQUEST" \
--header "Content-Type: application/json" \
--data-binary "@request.json"

返回说明​

返回业务包装;成功的 data 为写入结果,通常包含影响数量 number、结果数据集 dataSet 等。数据集内容随操作和部署变化,不承诺固定的 ids、updatedIds 或 deletedIds 字段。先检查业务状态与影响数量,再按实际 ID 或唯一业务键查询核对。删除后的 dataSet 可能为空,不能据此单独判断失败。

使用说明与排错​

批量删除使用独立的 /batchDelete 路径。本例将两个 ID 等值条件用 OR 连接,避免猜测 IN 比较码。join 是当前节点与同层前项的连接方式,因此同层各项按 OR 构造。先用相同条件分页核对全部目标,再删除;不要把多个 ID 作为一个等值条件的多个 values。