api.transglot.ai/v1Bearer Token，單一專案參考文件

上傳檔案。取回所有語言版本。

用於翻譯應用程式的 REST API。一次 POST 上傳原始檔，一次 GET 取回完成的語系檔，而 Bearer Token 即是完整的驗證機制。任何支援 HTTP 的工具皆可驅動此 API。

輸入：一次呼叫

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

輸出

300,000

Starter 方案每月字數，首個可產生 Token 的方案。

免費開始查看開發者介面

每個 Token 每分鐘 60 次請求 · 每次 429 錯誤皆附帶 Retry-After · CI 與生產環境請使用獨立 Token

控制台即 API 用戶端

推送、翻譯、閘控與拉取，每一項皆為 REST 端點。

下圖中的每一列背後皆對應一條路由：推送、閘控、術語庫、批次與拉取，皆可透過專案 Token 從您的程式碼存取。控制台中的 API 遊樂場會針對您的專案即時執行唯讀操作，讓您優先檢視真實回應。

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

您上傳原始檔
POST/v1/push
閘控面板自動填入
POST/v1/qa/run
您鎖定術語
POST/v1/glossary
批次檢視自動輪詢
GET/v1/batches/:id
您取回翻譯內容
GET/v1/pull

每個面板對應一條路由，每分鐘 60 次，權限依 Token 而定 · 匯出翻譯也是一個端點

僅需 HTTP

團隊優先建構的四項功能。

每一項皆為單一端點與專案 Token · 無需耗費整個下午

合併閘道 · 單一工作流程檔案

當翻譯失敗時，將 Pull Request 標記為紅色。

Cron · 每晚

每晚自動翻譯版本說明。

機器人 · 單一訂閱

批次完成時立即發布至 Slack。

代理程式 · MCP

賦予 AI 代理與您相同的 17 項工具。

每分鐘請求數

依 Token 計算，非依帳號計算，每次 429 錯誤皆附帶 Retry-After 標頭，指明需等待的秒數。

檔案格式

推送與拉取您儲存庫已使用的格式。複數形式與預留位置在雙向同步中皆能保留。在任一呼叫中使用 format= 來命名。

Webhook 事件

完整目錄，每個事件皆提供與實際傳送完全一致的範例負載。GET /v1/webhooks/events。

MCP 工具

相同的專案權杖，交給代理執行環境而非 curl。npx -y @transglot/mcp。

常見問題

開發者在發出第一個請求前常問的問題。

如何透過 Transglot API 進行身分驗證？

傳送 Bearer 權杖：Authorization: Bearer $TRANSGLOT_TOKEN。該權杖屬於單一專案，因此路徑中無專案 ID，也不會有洩漏的帳戶層級金鑰。您可以在專案頁面建立權杖，每個權杖皆具備各自的能力：推送、拉取、管理、讀取、寫入。

API 是否免費？

否。Bearer 權杖從 Starter 方案開始，每月 $19。免費方案涵蓋控制台，足以讓您評估產品是否符合需求，但無法產生權杖。CLI、GitHub Action、Webhooks、MCP 與交付套件皆使用同一個權杖，因此它們會一併啟用。

如何將字串上傳至 Transglot？

POST /v1/push 並附上檔案及其格式，例如 -F "file=@lang/en.json" -F "format=laravel_json"。系統會回應 202 並將批次加入佇列。僅翻譯實際變更的行，因此推送未變更的檔案不會產生費用。

如何取得我的翻譯內容？

GET /v1/pull，支援 20 種格式，隨時皆可存取。這是 CLI 封裝的端點，也是 API 遊樂場即時運作的端點。無需提交匯出請求，資料也永遠屬於您。

API 速率限制為何？

每分鐘 60 次請求，以權杖為單位計算而非帳戶。超出限制時，您會收到含 Retry-After 標頭的 429 回應，告知需等待的秒數，且不會產生費用或造成部分寫入。為 CI 與生產環境使用不同的權杖，可避免雜訊構建影響應用程式。

API 支援哪些語言？

沒有固定清單。驗證器接受 ICU 識別的任何 BCP-47 標籤，其對照表包含 708 個區域設定，並為表外標籤提供結構性回退機制。將區域設定新增至專案後，下次推送即會包含該語言。

我可以推送與拉取哪些檔案格式？

二十種：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。其中七種支援複數形式，且返回的檔案格式與輸入時一致。

Transglot 是否提供 Webhooks？

是。共有 12 種 Webhook 事件，包括 batch.completed、translation.reviewed、qa.completed 與 source_drift.repaired。每次傳送皆使用時間戳記標頭進行 HMAC 簽署以便驗證，而 GET /v1/webhooks/events 會返回目录及每個事件的範例負載。

是否有供 AI 代理使用的 MCP 伺服器？

是的。npx -y @transglot/mcp 會透過您的專案權杖公開 17 項工具，讓助理能夠讀取翻譯、撰寫翻譯、新增語言、啟動執行、檢查批次或編輯術語表。這與 API 和權限相同，只是從代理執行階段而非 curl 進行存取。

我可以在 CI 中執行嗎？

是的。GitHub Action (transglot/transglot-action@v1) 和 CLI 都封裝了這些端點。當某列被拒絕時，transglot push --wait 會以退出碼 4 結束，且該執行的 Action 作業會失敗。若要停止合併，請在拉取請求上執行它，並將 commit 輸入設為 none，新增一個在被拉取的檔案缺少金鑰時失敗的步驟，並使該作業成為分支保護中的必要檢查。

當翻譯未通過品質檢查時會發生什麼事？

四個決定性閘道會讀取每一列：預留位置、複數形式、術語表和長度。損壞的預留位置、缺少的複數形式或被禁止的術語表項目會獲得一次自動修正重試，若仍然失敗，該列會被拒絕而非寫入。僅超出長度的列會被寫入，不會被拒絕。GET /v1/batches/:id?include=failures 會列出被拒絕的列及其原因。

API 是否會破壞我的整合？

不會。/v1 只會新增端點與回應欄位；您已解析的欄位不會改變結構或消失。破壞性變更將透過新的版本前綴發布，該前綴目前保留且為空。API 變更日誌會記錄每次發布。