除非您接受，否则可选的分析、会话录制和广告将保持关闭。您可以拒绝它们并继续使用 Transglot。随时可在 Cookie 偏好设置中更改您的选择。 Cookie 政策

transglot.API 日志免费开始

API v1 · 当前版本

API 变更日志。
无移除项。

/v1 仅做增量更新。新的端点和响应字段均在同一前缀下发布，已解析的字段永远不会改变结构或消失。破坏性变更将在新版本前缀下发布，该前缀目前保留且为空。

v1/api/v1
唯一使用中的前缀

5 次发布

11 项变更，均非破坏性

日志概览

单一版本前缀，无移除项。

其中三项是此日志本身的属性。第四项是 API 提供的 Webhook 目录规模。

5

/v1 上的发布，均为增量更新

1

正在使用的版本前缀。下一个前缀已保留且为空

0

自 API 发布以来的破坏性变更

12

签名 Webhook 事件。来源：App\Enums\WebhookEvent

按发布日期排序，而非语义化版本

使用方向键浏览

2026-07-08

CDN 分发、用量统计和 Playground

July 8, 2026 · 4 项变更

05 / 05

added

它返回 ETag 和短期缓存，并尊重 If-None-Match 头以返回 304 状态码。/v{n} 下的不可变兄弟版本采用内容寻址，缓存期为一年。

公开且可边缘缓存的 GET /v1/cdn/{project}/{locale} 用于提供您已发布的字符串。

added

在 CI 中通过 POST /v1/cdn/publish 触发，并使用 X-Transglot-Cdn-Key 头中的专用只读密钥授权读取。可以安全地将其置于您自己的 CDN 之后。

发布操作将当前翻译提升为新的不可变版本，支持手动触发或在每次推送时自动触发。

added

不存储任何请求正文。仅进行计数，无其他操作。

每个经过身份验证的 /v1 调用均按令牌每天计数，并在部署中心显示。

improved

支持项目、拉取、批次和术语库导出。为实现此功能，请求或响应结构未发生任何变化。

部署中心新增 API Playground，可针对您的项目实时运行只读端点。

弃用登记册

没有任何功能会被移除。

每个已发布的界面占一行，并注明其发布的版本。最后一列是需要关注的重点：如果计划移除某项功能，会在此列提前很久标注日期。

没有任何功能
界面	已交付	状态	移除日期
GET /v1/project · /pull · POST /push · /translate · GET /batches	April 2, 2026	当前	暂无计划
POST /v1/incontext/session · /translations · /screenshots · /suggest	May 20, 2026	当前	暂无计划
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract	June 12, 2026	当前	暂无计划
POST /v1/qa/run	June 12, 2026	当前	暂无计划
Signed webhook events, twelve typed cases	June 30, 2026	当前	暂无计划
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish	July 8, 2026	当前	暂无计划

此表中的行永远不会被删除。如果某个界面停用，其行将保留并增加日期，因为能够提前规划移除操作正是发布此表的目的所在。

兼容性承诺

三条规则您可以在此基础上构建。

增量更新

新的端点和响应字段会在 /v1 中发布。您已解析的字段不会改变结构，也不会消失。

新前缀

破坏性变更将在新版本前缀下发布，而非在此版本内。该前缀目前保留且未使用，所有后续发布均基于 v1。

诚实的标头

当拉取操作无法完整往返某些内容时，会在标头中说明。我们添加了 X-Skipped-Keys 和 X-Missing-Source-Keys，而不是在底层更改响应体。

常见问题

开发者关于 API 版本控制和弃用的常见疑问。

Transglot API 是否有版本控制？

是的，通过 URL 前缀进行版本控制。目前发布的所有内容都位于 /v1 下，这是唯一在使用的前缀。没有版本标头，没有日期锁定，也无需任何配置。

更新会破坏我的集成吗？

在 /v1 内不会。我们会添加新的端点和响应字段，但您已解析的字段不会改变结构，也不会消失。如果某项变更无法以增量方式实现，它将在新前缀下发布，而旧前缀将继续正常工作。

是否有任何内容被弃用或移除？

没有，上述注册表逐行说明了这一点。每个已发布的接口都列出了其发布版本，移除列目前全部显示为“暂无计划”。

移除操作会提前多久通知？

移除操作会在发生很久之前就在注册表中显示具体日期，并且该行在之后仍会保留在表中，不会消失。提供可规划的日期正是发布此表的目的所在。

我如何知道何时发布了新功能？

每次发布都会在此页面标注日期。产品更新日志涵盖其他所有发布内容，控制台会在有您未读内容时显示标记。

为什么 API 要有单独的更新日志？

因为 API 承载着产品发布所不具备的兼容性承诺。开发者在检查集成是否仍然有效时，不应被迫滚动浏览功能开发内容才能找到答案。

如何将 API 添加到我的套餐中？

Bearer Token 从每月 19 美元的 Starter 套餐开始。免费套餐涵盖控制台，但无法生成 Token，而 CLI、GitHub Action、Webhooks 和 MCP 都需要使用该 Token。

端点本身的参考文档在哪里？

在 API 页面：包括身份验证、端点、速率限制、文件格式和 Webhook 目录。本页面仅记录变更内容及其时间。

合约即产品

基于 API 构建稳定不移。

免费开始阅读 API 参考文档

API 适用于 Starter 及更高版本。免费版起赠 100,000 字（注册时 25,000 字，完成手机验证后额外获得 75,000 字），之后每月赠送 10,000 字，不支持 API 和 Webhook。