Skip to main content
PUT
保存一种语言的译文

端点

认证:需要 API Key,且仅 App 作者(发布者本人)可调用;其他人得到 404。 整份替换某种语言的 overlay,来源记为 author。保存译文不会产生 Release:译文挂在 App 身份上,对所有版本生效。 硬检查(400):语言代码合法且不等于 App 的 source_locale;条目必须把路径映射到字符串或字符串数组;单个 App 最多 20 种语言;超过 4MB 为 413。路径级问题(未知路径、类型不符、enum_titles 长度与 enum 不匹配、事件或示例 id 重复)作为 warnings 返回而不拒绝,消费侧跳过这些条目。 哈希基准是工作区(作者翻译时看到的内容),没有草稿时回落到最新 Release;响应里的 stale 按最新 Release 计算,所以为尚未发布的草稿改动保存的译文会报 stale=true,直到那次改动发布。expected_revision 不一致为 409。

请求

路径参数

string
必填
App 引用。
string
必填
语言代码。

请求体

object
必填
译文条目,键为 manifest 路径,值为字符串或字符串数组。
integer
期望的当前草稿版本号。

示例请求

响应

200 成功

响应包在 data 字段中,其内容如下。
string
必填
语言代码。
enum
必填
译文来源。 取值:author / platform。
integer
必填
—
string
—
string
必填
—
boolean
必填
原文是否已在译文之后变化。
string[]
发生变化的路径。
object[]
路径级告警。

错误

错误响应统一为 {"error": {code, category, message, retryable}},见错误。

客户端库

Python 与 JavaScript SDK 暂未封装此端点,请直接调用 REST。