上传文件。 还原所有语言版本。

发送 bearer 令牌：Authorization: Bearer $TRANSGLOT_TOKEN。该令牌归属于单个项目，因此路径中无需项目 ID，也不存在可能泄露的账户级密钥。您可以在项目页面创建令牌，每个令牌拥有独立权限：推送、拉取、管理、读取、写入。

不免费。Bearer 令牌起始于 Starter 计划，每月 19 美元。免费版涵盖控制台功能，足以评估产品是否适用，但无法生成令牌。CLI、GitHub Action、Webhooks、MCP 和交付包均受同一令牌保护，因此它们会一并生效。

通过 POST /v1/push 上传文件并指定格式，例如 -F "file=@lang/en.json" -F "format=laravel_json"。接口返回 202 状态码并将任务加入队列。仅翻译实际变更的行，因此推送未更改的文件不会产生费用。

随时通过 GET /v1/pull 以 20 种格式中的任意一种获取数据。这是 CLI 封装的端点，也是 API playground 实时运行的端点。无需提交导出请求，数据始终归您所有，不存在访问窗口限制。

每分钟 60 次请求，按令牌而非账户计数。超出限制将返回 429 状态码及 Retry-After 标头，指明需等待的秒数，且不会产生费用或半写入情况。为 CI 和生产环境分配独立的令牌，可避免嘈杂的构建过程耗尽应用资源。

没有固定列表。验证器接受 ICU 识别的任何 BCP-47 标签，其对照表包含 708 个区域设置，并为表外标签提供结构回退。向项目添加区域设置后，下次推送即可包含该语言。

二十种：扁平 JSON 和嵌套 JSON、Laravel PHP 和 JSON、Android XML、iOS .strings、.stringsdict 和 .xcstrings、Flutter ARB、XLIFF 1.2 和 2.0、gettext .po、YAML、CSV、XLSX、Java properties、RESX、Markdown、Unity CSV 和 Unreal PO。其中七种支持复数形式，文件返回时将保持原有结构。

支持。共有 12 种 Webhook 事件，包括 batch.completed、translation.reviewed、qa.completed 和 source_drift.repaired。每次交付均使用 HMAC 签名并附带时间戳标头，以便您进行验证。GET /v1/webhooks/events 返回目录及每个事件的示例负载。

是的。npx -y @transglot/mcp 通过您的项目令牌公开 17 种工具，因此助手可以读取翻译、编写翻译、添加语言、启动运行、检查批次或编辑术语表。这是相同的 API 和相同的权限，只是从智能体运行时而非 curl 进行访问。

是的。GitHub Action (transglot/transglot-action@v1) 和 CLI 都封装了这些端点。当某行被拒绝时，transglot push --wait 将以退出码 4 结束，且该 Action 会在该次运行中使作业失败。要阻止合并，请在拉取请求上运行它，并将其 commit 输入设置为 none，添加一个在拉取的文件缺少键时失败的步骤，并将该作业设为分支保护中的必需检查。

四个确定性门禁会检查每一行：占位符、复数形式、术语表和长度。损坏的占位符、缺失的复数形式或被禁用的术语表词条将获得一次自动纠正重试，如果仍然失败，该行将被拒绝而非写入。仅超出长度限制的行会被写入，不会被拒绝。GET /v1/batches/:id?include=failures 列出被拒绝的行及其原因。

不会。/v1 只会增加端点和响应字段；您已解析的字段不会改变结构或消失。破坏性变更将在新版本前缀下发布，该前缀目前保留且为空。API 变更日志记录了每次发布。