面向开发者的 transglotapi, cli, mcp
翻译您的字符串 通过 CI,而非仪表板。
免费查看您的网站的法语、德语和西班牙语版本。无需注册。无需设置。
提供带有范围限定令牌 REST API、12 个使用 HMAC 签名的 webhook 事件、编辑器可调用的 MCP 服务器,以及 20 种无需重写架构即可往返的文件格式。推送文件,取回语言包。
无
借助
需要有人记得打开的仪表板。
CLI 和 GitHub Action 在 CI 中使用范围限定的项目令牌运行,从 Starter 计划开始支持。
中间的格式转换器,悄悄丢弃复数和注释。
原生读写二十种格式,确保复数、占位符和注释在往返过程中得以保留。
轮询端点以确认运行是否完成。
12 个 webhook 事件对时间戳和正文进行签名,以便接收方可以执行自己的重放窗口限制。
您可以调用的方式
五种接入方式, 一个项目令牌。
所有五种方式均使用相同的范围限定令牌进行身份验证,免费套餐无法生成该令牌。它们从 Starter 套餐开始提供。
- cli
transglot push 和 transglot pull
读取您已有的文件,并将生成的区域设置写回其中。采用 MIT 许可证,并在 npm 上发布。
Starter 及以上套餐 - action
GitHub Action
transglot/transglot-action 在推送时起草并将区域设置提交到同一分支。采用 MIT 许可证,仓库公开。
github.com - api
REST API
每个令牌每分钟六十个请求。pull 端点是获取所有字符串的支持方式。
/api - mcp
MCP 服务器
您的代理直接调用 17 个 MCP 工具,其中四个是术语表 CRUD 集合。
Starter 及以上套餐 - cdn
CDN 上的区域设置包
发布区域设置 JSON 包,并在运行时从边缘节点读取,而不是为修复文案而发布新构建版本。
Starter 及以上套餐
故意不提供通过浏览器下载翻译的功能。导出方式包括 pull 端点、CLI、CDN 包和文件存储同步。
FAQs
开发者在编写第一个调用前需要检查的事项。
是否有可以从我的代码中调用的翻译 API?
是的:REST API v1、npm 上的 CLI、GitHub Action、拥有 17 个工具的 MCP 服务器,以及 12 个签名的 webhook 事件。所有五项均使用相同的范围项目令牌进行身份验证,免费计划无法生成该令牌,因此它们从 Starter 计划(每月 19 美元)开始可用。
免费套餐具体提供什么?
一个项目,起步赠送 100,000 字(注册时 25,000,电话验证后 75,000)及之后每月 10,000 字,三个席位,以及 15 行区域设置(包括源语言),即 14 种目标语言。免费版无法生成项目令牌,因此 CLI、Action、API、Webhooks 和 MCP 服务器均从 Starter 计划开始可用。
如何将翻译集成到我的 CI 流水线中?
添加 GitHub Action。它会在推送时起草每种映射的语言,并将其提交到工作流运行的分支,因此在功能分支上,翻译会随更改一起出现在该分支的拉取请求中,而不是在更改之后。CLI 可从任何其他运行器推送和拉取,使用 --wait 时,如果运行失败则以非零状态退出,这会使步骤显示为红色,而不是让被拒绝的行悄悄通过。
API 速率限制是多少?
每个项目令牌每分钟 60 个请求。限制是基于令牌而非组织,因此嘈杂的 CI 任务不会耗尽您生产环境读取器的配额。
Webhook 如何签名,以及如何防止重放攻击?
每次交付都携带时间戳标头和基于时间戳及正文计算的 HMAC 签名。我们发布的时间戳允许您的接收端强制执行其所需的任何重放窗口;我们不会为您强制实施特定的窗口。
你们发送哪些 webhook 事件?
12 种 webhook 事件:batch.completed、batch.failed、key.created、key.updated、key.deleted、translation.updated、translation.reviewed、language.added、language.removed、glossary.updated、qa.completed 和 source_drift.repaired。同一列表可通过 GET /v1/webhooks/events 读取,因此您的代码无需硬编码它。
项目令牌能做什么,我可以缩小其权限范围吗?
令牌具有五种能力:push、pull、manage、read 和 write,还有一个针对仅需移动文件的作业的三能力 deploy 子集。令牌是按项目生成的,因此一个令牌无法访问非为其生成的项目。
哪些文件格式支持复数形式?
二十种格式中的七种:Android XML、iOS stringsdict、iOS xcstrings、Flutter ARB、gettext PO、CSV 和 XLSX。Laravel PHP 不支持,其编解码器会拒绝该行,而不是发明一种形式。
是否有适用于我的编码代理的 MCP 服务器?
是的,拥有 17 个工具,因此代理可以读取项目、列出和添加语言、获取和更新单个翻译、拉取和推送整个文件、翻译缺失内容、轮询或取消批次、重试失败的批次以及在不离开编辑器的情况下运行 QA。十七个工具中有四个是术语表工具。取消批次会将其未使用的单词返还到您的额度中。
当翻译未通过检查时会发生什么?
错误的占位符、缺失的复数形式或禁止的术语表术语将获得一次自动修正重试,并对返回的内容再次运行检查。如果仍然失败,该行将被拒绝,而不是写入您的文件。仅超出长度限制的行会被写入,从 Team 计划开始,自动批准或 QA 运行会将其标记为待审核。
我可以在不发布新版本的情况下更改字符串吗?
在 Web 上可以。从 Starter 套餐将语言区域包发布到 CDN 并在运行时读取,因此文案修复只需发布而无需版本更新。原生应用仍从文件格式中获取字符串,需要重新构建。
如何取回所有字符串?
GET /v1/pull、CLI、CDN 包,或与 S3、Dropbox 或 Drive 的文件存储同步。我们特意不提供浏览器直接下载翻译的功能,因此请计划使用上述四种途径之一。
其中有开源部分吗?
CLI 采用 MIT 许可并在 npm 上发布,GitHub Action 也采用 MIT 许可并拥有公共仓库。托管应用程序本身(包括引擎和格式编解码器)是私有的,本网站上的任何内容都不应被解读为相反的意思。
与您正在运行的工具协同工作