transglot for developersapi, 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
每個權杖每分鐘可處理 60 個請求。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、Webhook 和 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 讀取相同的清單,因此您的程式碼無須硬編碼這些事件。
專案權杖能做什麼?我可以縮小其權限範圍嗎?
權杖具備五種能力:推送、拉取、管理、讀取與寫入;此外還有一個僅含三種能力的部署子集,適用於只需移動檔案的作業。權杖是依專案發行的,因此無法用於非其所屬的專案。
哪些檔案格式支援複數形式?
二十種格式中有七種支援:Android XML、iOS stringsdict、iOS xcstrings、Flutter ARB、gettext PO、CSV 和 XLSX。Laravel PHP 不支援,其編解碼器會直接拒絕該資料列,而非自行發明一種形式。
我的程式碼代理程式有 MCP 伺服器可用嗎?
是的,提供 17 個工具,讓代理程式能讀取專案、列出及新增語言、取得及更新單一翻譯、拉取和推送整個檔案、翻譯缺失內容、輪詢或取消批次作業、重試失敗作業,並在不離開編輯器的情況下執行品質保證。十七個工具中有四個是術語表工具。取消批次作業會將未使用的字數退還至您的配額。
當翻譯未通過檢查時會發生什麼事?
錯誤的預留位置、缺失的複數形式或禁止的術語詞彙會自動進行一次修正重試,並對返回內容再次執行檢查。若仍然失敗,該列會被拒絕而非寫入您的檔案。僅超出長度的列則會被寫入,並從 Team 方案開始,透過自動核准或品質保證執行標記以供審核。
我可以在不發布新版本的情況下修改字串嗎?
在網頁端可以。從 Starter 方案將地區設定套件發布至 CDN,並在執行階段讀取,因此修正文案只需發布而無須發行新版本。原生應用程式仍從檔案格式中讀取字串,需要重新建構。
如何取出所有字串?
透過 GET /v1/pull、CLI、CDN 套件,或與 S3、Dropbox 或 Drive 同步檔案儲存空間。我們刻意不提供瀏覽器下載翻譯的功能,請規劃使用上述四種方式之一。
有任何部分是開源的嗎?
CLI 採用 MIT 授權並發布於 npm,GitHub Action 也採用 MIT 授權且擁有公開儲存庫。託管應用程式本身(包括引擎和格式編解碼器)則是私有的,本網站上的任何內容均不應被解讀為相反說法。
與您現有的系統相容