批量查询 UGC 译文缓存 / Batch-look up cached UGC translations

POST

/ugc/translations

按文本内容哈希查询已缓存的译文。仅返回缓存命中的条目；未命中的哈希不会出现在响应中，调用方应继续展示原文。可附带 sources（哈希→源文本），缺失的条目将被加入后台翻译队列，客户端轮询本接口即可取回结果。

Look up cached translations by content hash. Only cache hits are returned — for missing hashes keep rendering the original text. Optionally include sources (hash → source text); missing entries are enqueued for background translation, and clients poll this endpoint to pick up the result.

请求参数

Body 参数application/json必填

示例

{
    "hashes": [
        "string"
    ],
    "lang": "en",
    "sources": {
        "property1": "string",
        "property2": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://nearcade.cn/api/ugc/translations' \
--header 'Content-Type: application/json' \
--data '{
    "hashes": [
        "string"
    ],
    "lang": "en",
    "sources": {
        "property1": "string",
        "property2": "string"
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "translations": {
        "property1": "string",
        "property2": "string"
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠409

🟠410记录不存在

🟠429

🔴500服务器错误

🔴502网关错误

修改于 2026-10-23 22:59:16

更新 AI 自动翻译偏好 / Update AI auto-translation preferences

获取地铁站排名 / Get metro station rankings