除非您接受，否則可選的分析、工作階段錄製和廣告將保持關閉。您可以拒絕它們並繼續使用 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 遞送、用量與遊樂場

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 遊樂場，可針對您的專案即時執行唯讀端點。

棄用登記

沒有任何項目即將移除。

每個已發布的表面各佔一行，並標示發布的版本。最後一欄是重點關注對象：若計劃移除，會提前很久在該處顯示日期。

沒有任何項目
表面	已發布	狀態	移除日期
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 及以上方案。免費方案為 $0，起始提供 100,000 字（註冊時 25,000 字，手機驗證後 75,000 字），之後每月 10,000 字，且不包含 API 或 Webhooks。