コンテンツへスキップ

オプショナルな分析、セッション記録、広告は、同意しない限り無効です。これらを拒否してTransglotを利用できます。選択はいつでもCookieの設定で変更できます。 Cookieポリシー

API v1 · 現在

API変更履歴。
削除なし。

/v1 は追加のみを行います。新しいエンドポイントと新しいレスポンスフィールドは同じプレフィックス内に追加され、すでに解析しているフィールドの形状が変化したり消滅したりすることはありません。破壊的変更は新しいバージョンプレフィックスの下で提供されますが、これは予約されており、現在は空です。

v1/api/v1
使用中の唯一のプレフィックス
5 リリース
11 件の変更、すべて非破壊的
ログの構造

単一のバージョンプレフィックス、 削除なし。

これら4つのうち3つは、このログ自体の属性です。残る1つは、APIが提供するWebhookカタログの規模です。
5

/v1 でのリリース、すべて追加のみ

1

使用中のバージョンプレフィックス。次は予約されており空です

0

API公開以来の破壊的変更

12

署名付きWebhookイベント。出典: App\Enums\WebhookEvent

SemVerではなくリリース日付による区分

2026-07-08

CDN配信、使用量、プレイグラウンド
July 8, 2026 · 4 件の変更
05 / 05
added
ETag と短命のキャッシュを返し、If-None-Match を尊重して 304 を返します。/v{n} 下の不変な兄弟はコンテンツアドレス指定され、1年間キャッシュされます。

公開されエッジキャッシュ可能な GET /v1/cdn/{project}/{locale} が、公開済み文字列を提供します。

added
CI で POST /v1/cdn/publish をトリガーし、X-Transglot-Cdn-Key ヘッダー内の専用読み取り専用キーで読み取りを認証します。独自のCDNの背後に配置しても安全です。

公開により、現在の翻訳が手動またはプッシュごとに新しい不変バージョンに昇格します。

added
リクエストボディは保存されません。これはカウントのみであり、他には何もありません。

認証された /v1 呼び出しはすべて、トークンごと日ごとにカウントされ、デプロイハブに表示されます。

improved
プロジェクト、プル、バッチ、用語エクスポート。これを実現するためにリクエストまたはレスポンスの形状は変更されていません。

デプロイハブに、プロジェクトに対して読み取り専用エンドポイントをライブで実行するAPIプレイグラウンドが追加されました。

非推奨レジスター

何も 廃止されません。

公開されたサーフェスごとに1行、提供したリリースと共に。最後の列が要確認です:削除がある場合は、実際に発生するずっと前にそこに日付が表示されます。
何も
サーフェス出荷済みステータス削除日
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

現在

予定なし

この表から行が削除されることはありません。サーフェスが退役した場合、その行は維持され日付が追加されます。計画できる削除こそが、これを公開する意義だからです。
互換性の約束

3つのルール 基盤として活用できます。

追加のみ

新しいエンドポイントとレスポンスフィールドは /v1 内で提供されます。すでに解析済みのフィールドは形状が変更されず、削除されることもありません。

新しいプレフィックス

破壊的変更は、このバージョン内ではなく、新しいバージョンプレフィックスの下で提供されます。そのプレフィックスは予約されており未使用で、v1 より上のすべてのリリースは v1 に着地しています。

誠実なヘッダー

プル処理でラウンドトリップできない項目がある場合、ヘッダーでその旨を通知します。ボディの内容を変更するのではなく、X-Skipped-Keys と X-Missing-Source-Keys が追加されました。

よくある質問

API のバージョン管理と廃止について開発者がよく尋ねる質問。

Transglot API はバージョン管理されていますか?
はい、URL プレフィックスによって管理されています。これまでに公開されたすべては /v1 の下にあり、これが使用中の唯一のプレフィックスです。バージョンヘッダー、日付固定、設定項目はありません。
/v1 内では発生しません。新しいエンドポイントとレスポンスフィールドは追加されますが、すでに解析済みのフィールドは形状が変更されず、削除されることもありません。変更を追加形式で行えない場合は新しいプレフィックスの下で提供され、古いプレフィックスは引き続き機能します。
何もありません。上記のレジスターに行ごとに記載されています。公開されているすべての表面は、提供されたリリースとともに一覧表示され、削除欄にはすべて「予定なし」と記載されています。
削除は、実際に発生するかなり前に日付付きでレジスターに表示され、その行は消えるのではなくテーブルに残ります。計画を立てられる日付を提供することが、これを公開する主な目的です。
すべてのリリースはこのページで日付が表示されます。製品チェンジログにはその他提供されるすべての情報が掲載され、コンソールには未読の項目がある場合にマーカーが表示されます。
API には製品リリースにはない互換性の約束があるためです。統合がまだ機能しているかを確認したい開発者が、機能に関する作業内容をスクロールして探さなくても済むようにするためです。
Bearer トークンは Starter プラン(月額 $19)から開始されます。無料プランではコンソールを利用できますがトークンを発行することはできず、CLI、GitHub Action、Webhook、MCP はいずれも同じトークンの背後にあります。
API ページにあります:認証、エンドポイント、レート制限、ファイル形式、Webhook カタログ。このページは、何が変わったかとその時期の記録のみです。
既存の環境で動作します

41個のコネクタ、すでに構築済み。

契約こそが製品です

API を基盤に構築 変化しないもの。

APIはStarterプラン以上で利用可能です。Freeプランは$0で、開始時に100,000単語(登録時25,000単語、電話番号確認後75,000単語)、その後は月間10,000単語が付与されます。APIやWebhookは利用できません。