added
Model kunci-deploy, di mana token pembawa ADALAH proyek. Ini adalah apa yang dijalankan oleh CLI dan GitHub Action.
api v1 · saat ini
Log perubahan API.
Tidak ada yang dihapus.
/v1 hanya menambahkan fitur. Endpoint baru dan kolom respons baru masuk ke dalam awalan yang sama, dan kolom yang sudah Anda uraikan tidak pernah berubah bentuk atau menghilang. Perubahan yang merusak akan dirilis di bawah awalan versi baru, yang dicadangkan dan masih kosong.
v1/api/v1
satu-satunya awalan yang digunakan
satu-satunya awalan yang digunakan
5 rilis
11 perubahan, tidak ada yang merusak
bentuk log
Satu awalan versi, tanpa penghapusan.
Tiga dari empat ini adalah properti dari log itu sendiri. Yang keempat adalah ukuran katalog webhook yang dilayani oleh API.
5
rilis pada /v1, semuanya bersifat tambahan
1
awalan versi yang digunakan. Yang berikutnya dicadangkan dan kosong
0
perubahan yang merusak sejak API diluncurkan
12
event webhook bertanda tangan. Sumber: App\Enums\WebhookEvent
ditandai berdasarkan rilis, bukan semver
gunakan tombol panah untuk menelusuri
2026-07-08
Pengiriman CDN, penggunaan, dan playground
July 8, 2026 · 4 perubahan
05 / 05
added
/v1/incontext/translations, /screenshots, dan /suggest menggerakkan editor visual, dengan CORS yang dibatasi hanya pada awalan tersebut.
POST /v1/incontext/session menukar kunci publik dan Origin dengan token sesi yang terikat cakupan.
improved
Ekspor bilingual sekarang melaporkan apa yang tidak dapat diputar-balik (round-trip) alih-alih diam-diam mengganti dengan teks sumber. Bidang yang ada tidak berubah, yang merupakan tujuan utama menempatkannya di dalam header.
GET /v1/pull kini memiliki header respons X-Skipped-Keys dan X-Missing-Source-Keys.
added
Ditambah /v1/glossary/import, /export, dan /extract, sehingga basis istilah dapat dipindahkan masuk dan keluar tanpa membuka konsol.
CRUD basis istilah lengkap melalui API: GET, POST, PUT, dan DELETE pada /v1/glossary.
added
Temuan muncul pada baris terjemahan yang sudah Anda tarik, sehingga tidak ada hal baru yang perlu dipolling.
POST /v1/qa/run memicu pemeriksaan kualitas agenik dan mengembalikan handle run.
added
Berlangganan per endpoint. Daftar itu sendiri berada di App\Enums\WebhookEvent, yang saat ini memiliki dua belas kasus; hitung enum tersebut, bukan baris ini.
Webhook bertanda tangan memancarkan event kunci, terjemahan, bahasa, glosarium, dan QA bersama dengan pasangan batch asli.
improved
Pengiriman membawa jumlah dan hingga dua puluh sampel, bukan satu panggilan per baris yang berubah. Log pengiriman mencatat setiap upaya dengan waktu percobaan ulang berikutnya.
Event berfrekuensi tinggi seperti translation.updated digabungkan menjadi satu pengiriman per jendela waktu, sehingga edit massal tidak pernah membanjiri endpoint.
added
Ini mengembalikan ETag dan cache berumur pendek serta menghormati If-None-Match dengan 304. Saudara immutable di bawah /v{n} dialamatkan berdasarkan konten dan di-cache selama satu tahun.
GET publik yang dapat di-cache di edge /v1/cdn/{project}/{locale} melayani string yang telah Anda publikasikan.
added
Picu di CI dengan POST /v1/cdn/publish, dan otorisasi pembacaan dengan kunci read-only khusus di header X-Transglot-Cdn-Key. Aman untuk ditempatkan di belakang CDN pilihan Anda.
Penerbitan mempromosikan terjemahan saat ini ke versi immutable baru, secara manual atau pada setiap push.
added
Tidak ada body permintaan yang disimpan. Ini hanyalah sebuah hitungan dan tidak lebih dari itu.
Setiap panggilan /v1 yang diautentikasi dihitung per token per hari, dan ditampilkan di hub deploy.
improved
Proyek, pull, batch, dan ekspor glosarium. Tidak ada bentuk permintaan atau respons yang diubah agar berfungsi.
Hub deploy kini memiliki playground API yang menjalankan endpoint read-only secara langsung terhadap proyek Anda.
daftar deprecation
Tidak ada yang akan dihapus.
Satu baris per permukaan yang dipublikasikan, dengan rilis yang menyertakannya. Kolom terakhir adalah yang perlu diperhatikan: penghapusan akan muncul di sana dengan tanggal jauh sebelum itu terjadi.
| Permukaan | Dirilis | Status | Tanggal penghapusan |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | saat ini | tidak ada yang dijadwalkan |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | saat ini | tidak ada yang dijadwalkan |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | saat ini | tidak ada yang dijadwalkan |
POST /v1/qa/run | June 12, 2026 | saat ini | tidak ada yang dijadwalkan |
Signed webhook events, twelve typed cases | June 30, 2026 | saat ini | tidak ada yang dijadwalkan |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | saat ini | tidak ada yang dijadwalkan |
Baris tidak pernah dihapus dari tabel ini. Jika sebuah permukaan dihentikan, barisnya tetap ada dan diberi tanggal, karena penghapusan yang dapat Anda antisipasi adalah tujuan utama dari publikasinya.
janji kompatibilitas
Tiga aturan yang dapat Anda bangun.
aditif
Endpoint baru dan bidang respons baru dirilis di dalam /v1. Bidang yang sudah Anda urai tidak berubah bentuk dan tidak hilang.
awalan baru
Perubahan yang merusak akan dirilis di bawah awalan versi baru, bukan di dalam versi ini. Awalan tersebut dipesan dan belum digunakan, dan setiap rilis di atasnya menggunakan v1.
header yang jujur
Ketika pull tidak dapat melakukan round-trip pada suatu hal, hal itu dinyatakan dalam header. X-Skipped-Keys dan X-Missing-Source-Keys ditambahkan daripada mengubah isi body di bawah Anda.
FAQ
Pertanyaan yang sering diajukan pengembang tentang penentuan versi API dan penghentian fitur.
Apakah API Transglot memiliki versi?
Ya, berdasarkan awalan URL. Semua yang telah diterbitkan sejauh ini berada di bawah /v1, yang merupakan satu-satunya awalan yang digunakan. Tidak ada header versi, tidak ada pinning tanggal, dan tidak ada yang perlu dikonfigurasi.
Akankah pembaruan pernah merusak integrasi saya?
Tidak di dalam /v1. Endpoint baru dan bidang respons baru ditambahkan, tetapi bidang yang sudah Anda uraikan tidak berubah bentuk dan tidak hilang. Jika suatu perubahan tidak dapat dilakukan secara aditif, perubahan tersebut akan masuk ke awalan baru, dan yang lama tetap berfungsi.
Apakah ada yang dihentikan atau dihapus?
Tidak ada, dan register di atas menyatakan hal tersebut baris per baris. Setiap permukaan yang diterbitkan dicantumkan dengan rilis yang mengantarkannya dan kolom penghapusan yang saat ini bertuliskan "tidak dijadwalkan" hingga ke bawah.
Berapa banyak pemberitahuan yang akan diberikan untuk penghapusan?
Pilih tile di atlas. Setiap bahasa terbuka di sini: arah penulisan, bentuk jamak yang diperlukan, placeholder yang harus dibawa, dan struktur yang harus dipertahankan oleh terjemahan
Bagaimana saya tahu kapan sesuatu yang baru dirilis?
Setiap rilis diberi tanggal di halaman ini. Changelog produk mencakup semua hal lain yang dirilis, dan konsol menampilkan penanda ketika ada sesuatu yang belum Anda baca.
Mengapa ada changelog terpisah untuk API?
Karena API membawa janji kompatibilitas yang tidak dimiliki oleh rilis produk. Pengembang yang memeriksa apakah integrasi masih berfungsi tidak perlu menggulir melewati pekerjaan fitur untuk mengetahuinya.
Bagaimana cara menambahkan API ke paket saya?
Token bearer dimulai dari paket Starter seharga $19 per bulan. Paket Gratis mencakup konsol tetapi tidak dapat membuat token, dan CLI, GitHub Action, webhook, serta MCP semuanya memerlukan token tersebut.
Di mana referensi untuk endpoint itu sendiri?
Pada halaman API: autentikasi, endpoint, batas laju, format file, dan katalog webhook. Halaman ini hanya mencatat perubahan dan waktunya.
berfungsi dengan apa yang sudah Anda jalankan
41 konektor, sudah tersedia.
kontrak adalah produknya
Bangun dengan API yang tidak berubah.
API tersedia di paket Starter dan di atasnya. Paket Gratis seharga $0 dengan 100.000 kata untuk memulai (25.000 saat mendaftar, 75.000 setelah verifikasi telepon), 10.000 per bulan setelahnya, dan tanpa akses API atau webhook.