added
Model kunci penerasan, di mana token pembawa ADALAH projek tersebut. Ia adalah asas yang digunakan oleh CLI dan Tindakan GitHub.
api v1 · semasa
Log perubahan API.
Tiada apa-apa dialih keluar.
/v1 hanya menerima penambahan. Titik akhir baharu dan medan respons baharu dilancarkan dalam awalan yang sama, dan medan yang anda sudah huraikan tidak pernah berubah bentuk atau hilang. Perubahan pemecah akan dihantar di bawah awalan versi baharu, yang telah dikhaskan dan masih kosong.
v1/api/v1
satu-satunya awalan yang digunakan
satu-satunya awalan yang digunakan
5 keluaran
11 perubahan, tiada satu pun bersifat pemecah
bentuk log
Satu awalan versi, tiada penyingkiran.
Tiga daripada empat ini ialah sifat log itu sendiri. Yang keempat ialah saiz katalog webhook yang disediakan oleh API.
5
keluaran pada /v1, semuanya bersifat penambahan
1
awalan versi yang digunakan. Yang seterusnya telah dikhaskan dan kosong
0
perubahan pemecah sejak API dilancarkan
12
acara webhook bertandatangan. Sumber: App\Enums\WebhookEvent
ditandakan mengikut keluaran, bukan mengikut semver
gunakan kekunci anak panah untuk bergerak
2026-07-08
Penghantaran CDN, penggunaan dan taman permainan
July 8, 2026 · 4 perubahan
05 / 05
added
/v1/incontext/translations, /screenshots dan /suggest memacu editor visual, dengan CORS dibatasi kepada awalan itu sahaja dan tiada yang lain.
POST /v1/incontext/session menukar kunci boleh diterbitkan dan Origin dengan token sesi berskop.
improved
Eksport dwibahasa kini melaporkan apa yang tidak dapat dipusingkan semula (round-trip) dan bukannya menggantikan teks sumber secara senyap. Medan sedia ada tidak berubah, yang merupakan tujuan utama meletakkannya dalam pengepala.
GET /v1/pull memperoleh pengepala respons X-Skipped-Keys dan X-Missing-Source-Keys.
added
Ditambah dengan /v1/glossary/import, /export dan /extract, supaya pangkalan istilah boleh dipindahkan masuk dan keluar tanpa membuka konsol.
CRUD pangkalan istilah penuh melalui API: GET, POST, PUT dan DELETE pada /v1/glossary.
added
Penemuan muncul pada baris terjemahan yang sudah anda tarik, jadi tiada apa yang perlu dipolling secara baharu.
POST /v1/qa/run mencetuskan laluan kualiti ejen dan mengembalikan pemegang jalanan.
added
Langgan mengikut titik akhir. Senarai itu sendiri wujud dalam App\Enums\WebhookEvent, yang kini memegang dua belas kes; kira enum tersebut dan bukannya baris ini.
Webhook bertandatangan memancarkan acara kunci, terjemahan, bahasa, glosari dan QA bersama pasangan batch asal.
improved
Penghantaran membawa kiraan dan sehingga dua puluh sampel dan bukannya satu panggilan bagi setiap baris yang berubah. Log penghantaran merekodkan setiap percubaan dengan masa percubaan semula seterusnya.
Acara berfrekuensi tinggi seperti translation.updated digabungkan menjadi satu penghantaran setiap tetingkap, jadi edit pukal tidak akan membanjiri titik akhir.
added
Ia mengembalikan ETag dan cache jangka pendek serta menghormati If-None-Match dengan 304. Saudara tak berubah di bawah /v{n} dialamatkan kandungan dan dicache selama setahun.
GET /v1/cdn/{project}/{locale} yang boleh dicache di edge awam melayani rentetan yang telah diterbitkan.
added
Cetuskannya dalam CI dengan POST /v1/cdn/publish, dan sahkan bacaan dengan kunci baca-sahaja khusus dalam pengepala X-Transglot-Cdn-Key. Selamat untuk diletakkan di belakang CDN pilihan anda sendiri.
Penerbitan menaikkan terjemahan semasa ke versi tak berubah baharu, sama ada secara manual atau pada setiap push.
added
Tiada badan permintaan disimpan. Ia hanyalah kiraan dan tiada yang lain.
Setiap panggilan /v1 yang disahkan dikira per token sehari, dan dipaparkan pada hab deploy.
improved
Projek, tarik, batch dan eksport glosari. Tiada bentuk permintaan atau respons diubah untuk menjadikannya berfungsi.
Hab deploy memperoleh taman permainan API yang menjalankan titik akhir baca-sahaja secara langsung terhadap projek anda.
daftar penyahgunaan
Tiada apa yang akan hilang.
Satu baris bagi setiap permukaan yang diterbitkan, dengan rilis yang menghantarnya. Lajur terakhir ialah yang perlu diperhatikan: penyingkiran akan muncul di sana dengan tarikh jauh sebelum ia berlaku.
| Permukaan | Dihantar | Status | Tarikh penyingkiran |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | semasa | tiada dijadualkan |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | semasa | tiada dijadualkan |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | semasa | tiada dijadualkan |
POST /v1/qa/run | June 12, 2026 | semasa | tiada dijadualkan |
Signed webhook events, twelve typed cases | June 30, 2026 | semasa | tiada dijadualkan |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | semasa | tiada dijadualkan |
Baris tidak pernah dipadamkan daripada jadual ini. Jika permukaan bersara, ia mengekalkan barisnya dan mendapat tarikh, kerana penyingkiran yang boleh anda rancangkan adalah tujuan utama penerbitannya.
janji keserasian
Tiga peraturan yang boleh anda bina atasnya.
aditif
Titik akhir baharu dan medan respons baharu dihantar dalam /v1. Medan yang sudah anda huraikan tidak berubah bentuk dan tidak hilang.
awalan baharu
Perubahan pecah akan dihantar di bawah awalan versi baharu dan bukannya di dalam versi ini. Awalan itu dikhaskan dan tidak digunakan, dan setiap pelepasan di atasnya mendarat pada v1.
pengepala jujur
Apabila tarik tidak dapat memulangkan sesuatu, ia menyatakan demikian dalam pengepala. X-Skipped-Keys dan X-Missing-Source-Keys telah ditambah dan bukannya mengubah badan di bawah anda.
Soalan Lazim
Apa yang ditanya oleh pembangun tentang pengversionan API dan penyahaktifan.
Adakah Transglot API mempunyai versi?
Ya, melalui awalan URL. Semua yang diterbitkan setakat ini berada di bawah /v1, yang merupakan satu-satunya awalan yang digunakan. Tiada pengepala versi, tiada penetapan tarikh dan tiada apa-apa untuk dikonfigurasi.
Adakah kemas kini akan memecahkan integrasi saya?
Tidak di dalam /v1. Titik akhir baharu dan medan respons baharu ditambah, tetapi medan yang anda sudah huraikan tidak berubah bentuk dan tidak hilang. Jika perubahan tidak boleh dibuat secara tambahan, ia akan diletakkan di bawah awalan baharu, dan yang lama terus berfungsi.
Adakah ada apa-apa yang dinyahaktifkan atau dialih keluar?
Tiada apa-apa, dan daftar di atas menyatakan demikian baris demi baris. Setiap permukaan yang diterbitkan disenaraikan dengan keluaran yang meluncurkannya dan lajur penyingkiran yang kini berbunyi "tiada dijadualkan" sepanjang jalan ke bawah.
Berapa banyak notis akan diberikan untuk penyingkiran?
Penyingkiran akan muncul dalam daftar tersebut dengan tarikh padanya jauh sebelum ia berlaku, dan baris itu akan kekal dalam jadual selepasnya dan bukannya hilang. Tarikh yang boleh anda rancang adalah tujuan utama menerbitkannya.
Bagaimana saya tahu apabila sesuatu yang baharu dilancarkan?
Setiap keluaran bertarikh pada halaman ini. Log perubahan produk merangkumi segala-galanya yang lain yang dilancarkan, dan konsol menunjukkan penanda apabila ada sesuatu yang anda belum baca.
Mengapakah terdapat log perubahan berasingan untuk API?
Kerana API membawa janji keserasian yang tidak dibawa oleh keluaran produk. Pembangun yang menyemak sama ada integrasi masih berfungsi tidak perlu menatal melepasi kerja ciri untuk mengetahuinya.
Bagaimana saya menambah API kepada pelan saya?
Token bearer bermula pada pelan Starter pada $19 sebulan. Percuma meliputi konsol tetapi tidak boleh mencetak token, dan CLI, Tindakan GitHub, webhooks dan MCP semua berada di belakang token yang sama.
Di manakah rujukan untuk titik akhir itu sendiri?
Pada halaman API: pengesahan, titik akhir, had kadar, format fail dan katalog webhook. Halaman ini hanyalah rekod tentang apa yang berubah dan bila ia berlaku.
berfungsi dengan apa yang anda sudah jalankan
41 penyambung, sedia dibina.
kontrak ialah produk
Bina pada API yang tidak berubah.
API tersedia pada pakej Starter dan ke atas. Percuma ialah $0 dengan 100,000 perkataan untuk permulaan (25,000 semasa pendaftaran, 75,000 selepas semakan telefon), 10,000 sebulan selepas itu, dan tiada API atau webhook.