api.transglot.ai/v1Bearerトークン、1プロジェクトリファレンス

ファイルをプッシュ。すべての言語を取得。

アプリ翻訳用のREST API。POSTでソースファイルをアップロードし、GETで完成したロケールを取得します。認証はBearerトークンだけで完了。HTTPに対応していれば何でも利用可能です。

入力: 1回の呼び出し

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プランの月間単語数、トークン発行可能な最初のプラン。

無料で開始開発者向けインターフェースを見る

トークンごとに毎分60リクエスト · 429エラーにはRetry-Afterヘッダーが含まれます · CI環境と本番環境では別々のトークンを使用してください

コンソールはAPIクライアントです

プッシュ、翻訳、ゲート、プル、それぞれがRESTエンドポイント。

下図の各行には背後にルートがあります：プッシュ、ゲート、用語集、バッチ、プルなど、すべてプロジェクトトークンを使用して独自のコードからアクセス可能です。コンソールの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

パネルごとに1つのルート、毎分60回、トークンごとの権限 · 翻訳の配信もエンドポイントです

単なるHTTPです

チームが最初に構築する4つのこと。

それぞれが単一のエンドポイントとプロジェクトトークンです · どれも半日かかりません

マージゲート · ワークフローファイル1つ

翻訳が失敗した場合、プルリクエストを赤色にします。

cron · 毎日夜間

毎晩、リリースノートを overnight で翻訳します。

ボット · 1つのサブスクリプション

バッチが完了した瞬間にSlackへ投稿します。

エージェント · MCP

AIエージェントに、あなたと同じ17のツールを提供します。

毎分のリクエスト数

アカウントごとではなくトークンごとで、すべての429レスポンスにはRetry-Afterヘッダーが含まれ、待機すべき秒数が示されます。

ファイル形式

リポジトリで使用している形式でプッシュおよびプルします。複数形とプレースホルダーは双方向で維持されます。いずれかの呼び出しでformat=を使用して指定してください。

Webhookイベント

カタログ全体で、実際の配信と同じ形状のペイロード例が付属しています。GET /v1/webhooks/events。

MCPツール

curlではなくエージェントランタイムに渡される、同じプロジェクトトークンです。npx -y @transglot/mcp。

よくある質問

最初のリクエスト前に開発者が尋ねること。

Transglot APIではどのように認証を行いますか？

Bearerトークンを送信します: Authorization: Bearer $TRANSGLOT_TOKEN。トークンは1つのプロジェクトに属するため、パスにプロジェクトIDはなく、アカウント全体のキーが漏洩することもありません。トークンはプロジェクトページで作成でき、それぞれがpush、pull、manage、read、writeといった独自の権限を持ちます。

APIは無料ですか？

いいえ。BearerトークンはStarterプラン（月額19ドル）から利用できます。Freeプランではコンソールを利用でき、製品が要件に合うか確認できますが、トークンの発行はできません。CLI、GitHub Action、Webhook、MCP、配信バンドルはいずれも同じトークンを使用してアクセスするため、これらはすべて同時に利用可能になります。

Transglotに文字列をアップロードするにはどうすればよいですか？

ファイルとその形式を指定して POST /v1/push を実行します。例: -F "file=@lang/en.json" -F "format=laravel_json"。ステータスコード202が返され、バッチ処理がキューに登録されます。実際に変更された行のみが翻訳されるため、変更のないファイルをプッシュしてもコストは発生しません。

翻訳データを取得するにはどうすればよいですか？

GET /v1/pull を使用して、20種類の形式から好きなものを選択し、いつでも取得できます。これはCLIがラップしているエンドポイントであり、APIプレイグラウンドでライブ実行されているものです。エクスポートリクエストの提出は不要で、データへのアクセス権が制限される期間もありません。

APIのレート制限はどうなっていますか？

1分あたり60リクエストで、アカウント単位ではなくトークン単位でカウントされます。制限を超えると429エラーとRetry-Afterヘッダー（待機すべき秒数）が返され、課金や不完全な書き込みは発生しません。CI環境と本番環境で別々のトークンを使用すれば、ビルドプロセスの負荷がアプリに影響を与えることはありません。

APIはどの言語をサポートしていますか？

固定されたリストはありません。バリデーターはICUが認識する任意のBCP-47タグを受け付けます。これは照合テーブルに含まれる708のロケールに加え、それ以外のタグに対する構造的なフォールバックを含みます。プロジェクトにロケールを追加すると、次のプッシュ時にそれが含まれます。

プッシュおよびプルできるファイル形式はどれですか？

20種類：フラットJSONおよびネストJSON、Laravel PHPおよびJSON、Android XML、iOS .strings、.stringsdict、.xcstrings、Flutter ARB、XLIFF 1.2および2.0、gettext .po、YAML、CSV、XLSX、Javaプロパティ、RESX、Markdown、Unity CSV、Unreal PO。このうち7形式は複数形に対応しており、ファイルは元の構造のまま返されます。

TransglotにはWebhook機能がありますか？

はい。batch.completed、translation.reviewed、qa.completed、source_drift.repairedなど、12種類のWebhookイベントがあります。すべての配信には検証用のHMAC署名とタイムスタンプヘッダーが付与され、GET /v1/webhooks/events で各イベントのサンプルペイロードを含むカタログを取得できます。

AIエージェント向けのMCPサーバーはありますか？

はい。npx -y @transglot/mcp はプロジェクトトークン経由で17のツールを公開するため、アシスタントは翻訳の読み取り、書き込み、言語の追加、実行の開始、バッチの確認、用語集の編集を行えます。これは curl ではなくエージェントランタイムからアクセスされる、同じAPIで同じ権限です。

CIで実行できますか？

はい。GitHub Action（transglot/transglot-action@v1）とCLIの両方がこれらのエンドポイントをラップしています。行が拒否されると、transglot push --wait は終了コード4で終了し、Actionはその実行でジョブを失敗させます。マージを停止するには、プルリクエストで実行し、コミット入力をnoneに設定します。また、取得したファイルにキーがない場合に失敗するステップを追加し、そのジョブをブランチ保護の必須チェックとして設定してください。

翻訳が品質チェックに失敗した場合、どうなりますか？

プレースホルダー、複数形、用語集の用語、長さという4つの決定論的ゲートがすべての行を読み取ります。壊れたプレースホルダー、欠落している複数形、禁止されている用語集の用語がある場合、自動修正リトライが1回行われ、それでも失敗すると行は書き込まれずに拒否されます。長さのみを超えている行は、拒否されずに書き込まれます。GET /v1/batches/:id?include=failures は、拒否された行とその理由を一覧表示します。

APIの更新により統合が壊れることはありますか？

いいえ。/v1 ではエンドポイントとレスポンスフィールドが増えるだけで、既存のフィールドの構造が変わったり削除されることはありません。破壊的変更は新しいバージョンプレフィックスの下で提供されますが、現在は予約されており空の状態です。APIの変更履歴にはすべてのリリースが記録されています。

既存の環境で動作します