api.transglot.ai/v1token pembawa, satu proyekreferensi

Unggah file. Dapatkan kembali setiap bahasa.

API REST untuk menerjemahkan aplikasi Anda. Satu POST mengunggah file sumber, satu GET mengembalikan lokal yang sudah selesai, dan token pembawa adalah seluruh autentikasi. Apa pun yang mendukung HTTP dapat menjalankannya.

dalam: satu panggilan

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

keluar

300,000

kata per bulan di Starter, paket pertama yang dapat membuat token.

Mulai gratis Lihat antarmuka pengembang

60 permintaan per menit per token · setiap 429 menyertakan Retry-After · berikan token terpisah untuk CI dan produksi

konsol adalah klien API

Unggah, terjemahkan, batasi, dan tarik, masing-masing merupakan endpoint REST.

Setiap baris pada gambar di bawah memiliki rute di baliknya: push, gates, glossary, batches, dan pull, yang semuanya dapat diakses dari kode Anda sendiri dengan token proyek. Playground API di konsol menjalankan yang bersifat read-only secara langsung terhadap proyek Anda, sehingga Anda melihat respons nyata terlebih dahulu.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Anda mengunggah file sumber
POST/v1/push
Panel gates terisi
POST/v1/qa/run
Anda mengunci istilah
POST/v1/glossary
Tampilan batch melakukan polling otomatis
GET/v1/batches/:id
Anda mengambil kembali terjemahan
GET/v1/pull

satu rute per panel, 60 per menit, kemampuan per token · mendapatkan terjemahan Anda juga merupakan sebuah endpoint

hanya http

Empat hal yang pertama kali dibangun tim.

masing-masing adalah satu endpoint dan satu token proyek · tidak ada yang membutuhkan waktu seharian

merge gate · satu file alur kerja

Ubah pull request menjadi merah saat terjemahan gagal.

cron · setiap malam

Terjemahkan catatan rilis semalaman, setiap malam.

bot · satu langganan

Posting ke Slack segera setelah batch selesai.

agent · mcp

Berikan agen AI 17 alat yang sama seperti yang Anda miliki.

permintaan per menit

per token, bukan per akun, dengan header Retry-After pada setiap 429 yang menyatakan berapa detik harus menunggu.

format file

push dan pull format yang sudah digunakan repositori Anda. Plural dan placeholder tetap utuh di kedua arah. Namakan dengan format= pada salah satu panggilan.

event webhook

seluruh katalog, masing-masing dengan contoh payload dalam bentuk persis seperti pengiriman nyata. GET /v1/webhooks/events.

alat mcp

token proyek yang sama, diberikan ke runtime agen alih-alih ke curl. npx -y @transglot/mcp.

FAQ

Apa yang ditanyakan developer sebelum permintaan pertama.

Bagaimana cara saya melakukan autentikasi dengan Transglot API?

Kirim bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. Token tersebut milik satu proyek, sehingga tidak ada project id di path dan tidak ada kunci tingkat akun yang bocor. Anda membuat token di halaman proyek dan masing-masing membawa kemampuannya sendiri: push, pull, manage, read, write.

Apakah API ini gratis?

Tidak. Token bearer dimulai dari paket Starter seharga $19 per bulan. Versi gratis mencakup konsol, yang cukup untuk melihat apakah produk ini sesuai, tetapi tidak dapat membuat token. CLI, GitHub Action, webhook, MCP, dan paket pengiriman semuanya berada di balik token yang sama, sehingga semuanya tersedia bersamaan.

Bagaimana cara mengunggah string ke Transglot?

POST /v1/push dengan file dan formatnya, misalnya -F "file=@lang/en.json" -F "format=laravel_json". Ini akan merespons dengan kode 202 dan menjadwalkan batch. Hanya baris yang benar-benar berubah yang akan diterjemahkan, sehingga mengunggah file yang tidak berubah tidak dikenakan biaya.

Bagaimana cara mengambil kembali terjemahan saya?

GET /v1/pull, dalam salah satu dari 20 format, kapan pun Anda mau. Ini adalah endpoint yang dibungkus oleh CLI, dan yang dijalankan langsung oleh playground API. Tidak ada permintaan ekspor ke file dan tidak ada periode di mana data berhenti menjadi milik Anda.

Berapa batas rate limit API?

60 permintaan per menit, dihitung per token bukan per akun. Jika melebihi batas, Anda akan menerima respons 429 dengan header Retry-After yang menyatakan berapa detik harus menunggu, dan tidak ada biaya atau penulisan parsial yang terjadi. Berikan token terpisah untuk CI dan produksi agar build yang ramai tidak mengganggu aplikasi Anda.

Bahasa apa saja yang didukung oleh API?

Tidak ada daftar tetap. Validator menerima tag BCP-47 apa pun yang dikenali ICU, yaitu 708 lokal dalam tabel yang diperiksa, ditambah fallback struktural untuk tag di luar itu. Tambahkan lokal ke proyek dan push berikutnya akan menyertakannya.

Format file apa saja yang dapat saya unggah dan unduh?

Dua puluh: JSON datar dan bersarang, Laravel PHP dan JSON, Android XML, iOS .strings, .stringsdict dan .xcstrings, Flutter ARB, XLIFF 1.2 dan 2.0, gettext .po, YAML, CSV, XLSX, properti Java, RESX, Markdown, Unity CSV, dan Unreal PO. Tujuh di antaranya mendukung bentuk jamak, dan file dikembalikan dalam bentuk aslinya.

Apakah Transglot memiliki webhook?

Ya. Ada 12 event webhook, termasuk batch.completed, translation.reviewed, qa.completed, dan source_drift.repaired. Setiap pengiriman ditandatangani HMAC dengan header timestamp sehingga Anda dapat memverifikasinya, dan GET /v1/webhooks/events mengembalikan katalog dengan contoh payload untuk masing-masing event.

Apakah ada server MCP untuk agen AI?

Ya. npx -y @transglot/mcp menyediakan 17 alat melalui token proyek Anda, sehingga asisten dapat membaca terjemahan, menulisnya, menambahkan bahasa, memulai proses, memeriksa batch, atau mengedit glosarium. Ini adalah API dan izin yang sama, diakses dari runtime agen alih-alih dari curl.

Dapatkah saya menjalankannya di CI?

Ya. GitHub Action (transglot/transglot-action@v1) dan CLI keduanya membungkus endpoint ini. Ketika sebuah baris ditolak, transglot push --wait keluar dengan kode 4 dan Action membuat job gagal pada proses tersebut. Untuk menghentikan penggabungan, jalankan pada pull request dengan input commit diatur ke none, tambahkan langkah yang gagal ketika file yang ditarik kehilangan kunci, dan jadikan job sebagai pemeriksaan wajib dalam proteksi cabang.

Apa yang terjadi ketika terjemahan gagal pemeriksaan kualitas?

Empat gerbang deterministik membaca setiap baris: placeholder, bentuk jamak, istilah glosarium, dan panjang. Placeholder yang rusak, bentuk jamak yang hilang, atau istilah glosarium yang dilarang akan mendapatkan satu upaya korektif otomatis, dan jika masih gagal, baris tersebut ditolak daripada ditulis. Baris yang hanya melebihi batas panjangnya akan ditulis, bukan ditolak. GET /v1/batches/:id?include=failures mencantumkan baris yang ditolak beserta alasannya.

Akankah API pernah merusak integrasi saya?

Tidak. /v1 hanya menambahkan endpoint dan bidang respons; bidang yang sudah Anda parse tidak berubah bentuk atau hilang. Perubahan yang merusak akan dirilis di bawah awalan versi baru, yang sudah dipesan dan masih kosong. Changelog API mencatat setiap rilis.