查询翻译列表#

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

用途与 App 场景#

按筛选条件读取翻译（i18n 词条）列表（非分页，受 sqlQueryLimit 上限约束）。当前 Web 以本操作为 XLSX 导出取全量数据。本页描述当前 Web 可达调用与服务端实际合同，不把静态源码核验当作联调。

Web 使用位置#

协议身份#

前置条件与权限#

需要有效登录态，并满足 administrator 角色或 configuration-translation:read（TranslationController.java:147）。资源表受 MyBatis 租户拦截器按当前认证租户上下文约束（es-center-server-main-service/src/main/java/com/es/center/server/config/MybatisPlusConfig.java:72-88；configuration_translation 不在 tenant-id-ignore-tables 白名单），请求中的租户筛选字段不能代替空间切换。认证与空间。

输入#

词条筛选键（均可空）：translationId、language、namespace、key、value、createdUsername、createdTimeRangeStart/End、lastModifiedUsername、lastModifiedTimeRangeStart/End、deleteTimeRangeStart/End、revision、tenantId、tenantIds（DTO 同源字段）。

当前 Web XLSX 导出发送 { ...搜索条件, sqlQueryLimit: 100000 }（app/.common/hooks/use-xlsx-table-io.ts:9 XLSX_EXPORT_ROW_LIMIT），服务端钳制为同一上限。

输出、应答或事件#

data[] 元素字段：translationId（string）、language、namespace、key、value（string）、createdUsername/lastModifiedUsername（string）、createdTime/lastModifiedTime/deleteTime（number，epoch 秒或 null）、revision（number 或 null）、tenantId（string）。时间序列化见数据类型与时间；证据 gt-common-configuration-dto/src/main/java/tech/gt/configuration/dto/TranslationListResponseDTO.java。

完成判据#

status=200 且 data 数组可消费表示读取结束；[] 是成功空结果。读取直查数据库，无缓存窗口。

示例#

以下均为按已核验契约构造的示例，不是真实联调记录；ID、时间与租户为占位值。

请求：

1{
2  "language": "zh-CN",
3  "namespace": "translation",
4  "sqlQuerySorter": {
5    "field": "lastModifiedTime",
6    "order": "descend"
7  },
8  "sqlQueryLimit": 1000
9}

成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {},
8  "data": [
9    {
10      "translationId": "tr-01",
11      "language": "zh-CN",
12      "namespace": "translation",
13      "key": "Add",
14      "value": "新增",
15      "createdUsername": "administrator",
16      "createdTime": 1789142400,
17      "lastModifiedUsername": "administrator",
18      "lastModifiedTime": 1789142400,
19      "deleteTime": null,
20      "revision": 1,
21      "tenantId": "default"
22    }
23  ]
24}

信封字段证据：gt-common-core/src/main/java/tech/gt/api/ApiResult.java（成功/失败信封）与 es-center-server-main-service/src/main/java/com/es/center/server/config/JsonFormatConfig.java:20-113（时间序列化）。

错误与边界#

认证失败/权限失败：认证与资源权限拒绝的 wire 形态见错误差异页对应锚点。公共 Web helper 默认 15 分钟超时（app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson）。读取无副作用，可按网络策略重试。

调用关系与资源清理#

无长连接资源；XLSX 导出取数后由页面本地落盘。写操作成功后列表页会 reload 重新分页读取。

已知缺口#

无已知会阻止按当前源码调用的关键契约缺口。 仅完成双仓静态源码核验，未执行真实 HTTP、数据库或权限矩阵联调。

验证状态与依据#