批量删除行记录
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。