ES Documentation
手册
API
手册
API
简体中文

批量删除翻译

验证状态：已源码核验、未联调；适用基线：Web 7fe6dd10、services 89bd222c；核验日期：2026-09-12

用途与 App 场景

按 translationId 集合批量删除翻译词条（逻辑删除）。当前 Web 翻译列表勾选批量删除使用本操作。

Web 使用位置

页面/功能 角色或空间分支 调用证据
列表勾选批量删除 前端入口要求 administrator 或 configuration-translation:delete app/routes/($lng).$spaceId.configuration.translation._index/route.tsx:395-419

协议身份

项 值
operationId http-delete-main-service-system-api-configuration-translation-removebyids-436ffe0d
method + path DELETE /main-service/system-api/configuration/translation/removeByIds
base URL 当前 Web 使用同源相对 URL
headers Accept: application/json;charset=UTF-8；Authorization: Bearer <token>
序列化 query 由 qs.stringify(ids, { arrayFormat: "repeat" }) 构造为重复键（translationApi.ts:9）

前置条件与权限

需要有效登录态，并满足 administrator 角色或 configuration-translation:delete（TranslationController.java:97）。数据行受租户拦截器约束。认证与空间。

输入

JSON 路径/参数 JSON 类型 位置 必填 可空 默认值 枚举/范围/单位 说明 字段证据
ids array[string] query（重复键 ids=a&ids=b） 是 否 无 @NotEmpty("ids Cannot be empty.") 翻译主键集合 TranslationController.java:100-102；translationApi.ts:9-10

输出、应答或事件

JSON 路径 JSON 类型 出现条件 可空 枚举/范围/单位 说明 字段证据
timestamp/status/error/localizedError/path 同信封 JSON 响应 — — 成功 status=200 gt-common-core/src/main/java/tech/gt/api/ApiResult.java
extraData object 成功 否 — 恒为 {} 同上
data boolean 业务完成 否 — removeByIds 结果；逻辑删除，不可当 affected-rows 用 TranslationController.java:102；TranslationService.java:48-51

删除后最终翻译视图的移除触发链与单条删除相同（无 remove 专用通道，见删除单条翻译缺口）。

完成判据

status=200 表示批量逻辑删除已执行；列表页 onSuccess 后 reload 重读。

示例

按已核验契约构造的示例，不是真实联调记录。

请求：DELETE /main-service/system-api/configuration/translation/removeByIds?ids=tr-01&ids=tr-02

成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {},
8  "data": true
9}

错误与边界

认证失败/权限失败/请求校验失败。逻辑删除可按同参数重试（幂等）。

调用关系与资源清理

无长连接资源。批量删除后列表页 reload。

已知缺口

与单条删除相同：视图刷新触发链未由本仓源码闭合。 仅完成双仓静态源码核验，未执行真实 HTTP、数据库联调。

验证状态与依据

结论 状态 仓库/基线 路径、符号及定位 内容指纹（脏文件）
Web 方法、路径、序列化与消费 已源码核验 web 7fe6dd10 translationApi.ts:9 configurationTranslationRemoveByIdsApi；route.tsx:395-419 证据文件与 HEAD 一致
权限、输入、输出和完成语义 已源码核验 services 89bd222c TranslationController.java:98 removeByIds；TranslationService.java:48-51 证据文件与 HEAD 一致
真实部署联调 未执行 — 未发送请求 —
目录