跳到主要内容

删除行记录

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

项目内容
方法POST
路径/open-api/openapi/form/delete
认证用户 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": "AND",
"var": "id",
"compare": 10,
"values": [
"YOUR_RECORD_ID"
]
}
]
}
}
curl --request POST "https://admin.duoge.work/api/open-api/openapi/form/delete" \
--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 可能为空,不能据此单独判断失败。

使用说明与排错​

删除前先用相同 conditions 查询目标记录与数量,核对保留或恢复策略。不能用空 conditions 代替“按 ID 删除”。此操作不提交 columns.values;多记录选择见批量删除。