api.transglot.ai/v1token bearer, satu projekrujukan

Hantar fail. Dapatkan semula setiap bahasa.

API REST untuk menterjemah aplikasi anda. Satu POST memuat naik fail sumber, satu GET membawa kembali locale yang siap, dan token bearer ialah keseluruhan pengesahan. Apa sahaja yang menyokong HTTP boleh mengendalikannya.

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

perkataan sebulan pada Starter, pelan pertama yang boleh menjana token.

Mula secara percuma Lihat permukaan pembangun

60 permintaan seminit setiap token · setiap 429 membawa Retry-After · berikan token berasingan untuk CI dan pengeluaran

konsol ialah klien API

Hantar, terjemah, halang dan tarik, setiap satunya titik akhir REST.

Setiap baris dalam gambar di bawah mempunyai laluan di sebaliknya: hantar, halangan, glosari, kumpulan dan tarik, semua boleh dicapai dari kod anda sendiri dengan token projek. Ruang main API dalam konsol menjalankan yang baca-sahaja secara langsung terhadap projek anda, jadi anda melihat respons sebenar dahulu.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Anda memuat naik fail sumber
POST/v1/push
Panel gerbang diisi
POST/v1/qa/run
Anda mengunci istilah
POST/v1/glossary
Pandangan kumpulan menyoal sendiri
GET/v1/batches/:id
Anda mengambil kembali terjemahan
GET/v1/pull

satu laluan per panel, 60 seminit, keupayaan per token · mendapatkan terjemahan anda juga melalui titik akhir

ia hanyalah http

Empat perkara yang dibina pasukan terlebih dahulu.

setiap satu ialah titik akhir tunggal dan token projek · tiada satu pun mengambil masa sebelah petang

gerbang penggabungan · satu fail aliran kerja

Tukar permintaan tarik kepada merah apabila terjemahan gagal.

cron · setiap malam

Terjemahkan nota pelepasan pada waktu malam, setiap malam.

bot · satu langganan

Hantar ke Slack sebaik sahaja kelompok selesai.

ejen · mcp

Berikan ejen AI 17 alat yang sama seperti yang anda ada.

permintaan seminit

per token, bukan per akaun, dengan pengepala Retry-After pada setiap 429 menyatakan berapa saat untuk menunggu.

format fail

tolak dan tarik format yang sudah digunakan oleh repositori anda. Kata jamak dan pemegang tempat kekal dalam kedua-dua arah. Namakan dengan format= pada mana-mana panggilan.

acara webhook

seluruh katalog, masing-masing dengan muatan contoh dalam bentuk sebenar penghantaran. GET /v1/webhooks/events.

alat mcp

token projek yang sama, diserahkan kepada masa jalan ejen dan bukannya curl. npx -y @transglot/mcp.

Soalan Lazim

Apa yang ditanya oleh pembangun sebelum permintaan pertama.

Bagaimanakah saya mengesahkan dengan API Transglot?

Hantar token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. Token tersebut milik satu projek, jadi tiada id projek dalam laluan dan tiada kunci seluruh akaun yang boleh bocor. Anda mencipta token di halaman projek dan setiap satu membawa keupayaannya sendiri: tolak, tarik, urus, baca, tulis.

Adakah API ini percuma?

Tidak. Token bearer bermula pada pelan Starter pada harga $19 sebulan. Percuma merangkumi konsol, yang mencukupi untuk melihat sama ada produk sesuai, tetapi ia tidak boleh mencetak token. CLI, Tindakan GitHub, webhook, MCP dan pakej penghantaran semua berada di belakang token yang sama, jadi ia tiba bersama-sama.

Bagaimanakah saya memuat naik rentetan ke Transglot?

POST /v1/push dengan fail dan formatnya, contohnya -F "file=@lang/en.json" -F "format=laravel_json". Ia menjawab 202 dan mengaturkan kelompok. Hanya baris yang benar-benar berubah diterjemahkan, jadi menolak fail yang tidak berubah tidak menelan kos.

Bagaimanakah saya mendapatkan semula terjemahan saya?

GET /v1/pull, dalam mana-mana daripada 20 format, bila-bila masa anda mahu. Ia ialah titik akhir yang dibalut oleh CLI, dan yang dijalankan secara langsung oleh taman permainan API. Tiada permintaan eksport untuk difailkan dan tiada tetingkap di mana data berhenti menjadi milik anda.

Apakah had kadar API?

60 permintaan seminit, dikira mengikut token dan bukan mengikut akaun. Jika melebihi had ini, anda akan menerima kod ralat 429 dengan pengepala Retry-After yang menyatakan bilangan saat untuk menunggu, dan tiada caj dikenakan atau data ditulis separuh. Gunakan token berasingan untuk CI dan pengeluaran agar binaan yang bising tidak menghalang aplikasi anda.

Bahasa manakah yang disokong oleh API?

Tiada senarai tetap. Pengesah menerima mana-mana teg BCP-47 yang diiktiraf oleh ICU, iaitu 708 lokal dalam jadual yang disemak, ditambah dengan sandaran struktur untuk teg di luar jadual tersebut. Tambahkan lokal ke projek dan tolakan seterusnya akan menyertakannya.

Format fail manakah yang boleh saya tolak dan tarik?

Dua puluh: JSON rata dan bertingkat, 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 daripadanya membawa bentuk jamak, dan fail dikembalikan dalam bentuk asalnya.

Adakah Transglot mempunyai webhook?

Ya. Terdapat 12 acara webhook, termasuk batch.completed, translation.reviewed, qa.completed dan source_drift.repaired. Setiap penghantaran ditandatangani HMAC dengan pengepala cap masa supaya anda boleh mengesahkannya, dan GET /v1/webhooks/events mengembalikan katalog dengan sampel muatan bagi setiap satu.

Adakah terdapat pelayan MCP untuk ejen AI?

Ya. npx -y @transglot/mcp mendedahkan 17 alat melalui token projek anda, jadi pembantu boleh membaca terjemahan, menulisnya, menambah bahasa, memulakan pelaksanaan, menyemak kumpulan atau mengedit glosari. Ia adalah API dan kebenaran yang sama, dicapai dari masa jalan ejen dan bukannya dari curl.

Bolehkah saya menjalankannya dalam CI?

Ya. Tindakan GitHub (transglot/transglot-action@v1) dan CLI kedua-duanya membungkus titik akhir ini. Apabila baris ditolak, transglot push --wait keluar dengan kod 4 dan Tindakan gagal menjalankan tugas pada pelaksanaan tersebut. Untuk menghentikan penggabungan, jalankan ia pada permintaan tarik dengan input komit ditetapkan kepada tiada, tambah langkah yang gagal apabila fail yang ditarik kehilangan kunci, dan jadikan tugas sebagai semakan wajib dalam perlindungan cawangan.

Apakah yang berlaku apabila terjemahan gagal semakan kualiti?

Empat gerbang deterministik membaca setiap baris: pemegang tempat, kata jamak, istilah glosari dan panjang. Pemegang tempat yang rosak, bentuk kata jamak yang hilang atau istilah glosari yang dilarang mendapat satu percubaan pembetulan automatik, dan jika ia masih gagal, baris tersebut ditolak dan bukannya ditulis. Baris yang hanya melebihi had panjangnya akan ditulis, bukan ditolak. GET /v1/batches/:id?include=failures menyenaraikan baris yang ditolak dan sebabnya.

Adakah API akan pernah memecahkan integrasi saya?

Tidak. /v1 hanya menambah titik akhir dan medan respons; medan yang sudah anda huraikan tidak berubah bentuk atau hilang. Perubahan pemecahan akan dihantar di bawah awalan versi baharu, yang telah ditempah dan masih kosong. Log perubahan API merekodkan setiap pelepasan.