api.transglot.ai/v1bearer token, tek projereferans

Bir dosya gönderin. Tüm dilleri geri alın.

Uygulamanızı çevirmek için bir REST API. Kaynak dosyayı yüklemek için bir POST, bitmiş bir yerel ayarı geri almak için bir GET ve kimlik doğrulamanın tamamı bir bearer token. HTTP konuşan her şey bunu yönetebilir.

içeri: tek çağrı

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

dışarı

300,000

Starter planında ayda kelime, token oluşturabilen ilk plan.

Ücretsiz başla Geliştirici arayüzünü gör

Token başına dakikada 60 istek · her 429 yanıtı bir Retry-After bilgisi taşır · CI ve üretim için ayrı tokenlar kullanın

konsol bir api istemcisidir

Gönderin, çevirin, kontrol edin ve çekin, her biri bir REST uç noktasıdır.

Aşağıdaki resimdeki her satırın arkasında bir rota vardır: gönderme, kapılar, sözlük, toplu işler ve çekme; tümüne proje belirtecinizle kendi kodunuzdan erişilebilir. Konsoldaki API oyun alanı, salt okunur olanları projenize karşı canlı olarak çalıştırır, böylece önce gerçek bir yanıt görürsünüz.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Bir kaynak dosya yüklersiniz
POST/v1/push
Kapılar paneli doldurulur
POST/v1/qa/run
Bir terimi kilitlersiniz
POST/v1/glossary
Toplu görünüm kendini yoklar
GET/v1/batches/:id
Çevirileri geri alırsınız
GET/v1/pull

panel başına bir rota, dakikada 60, belirteç başına yetenekler · çevirilerinizi dışa aktarmak da bir uç noktadır

sadece http

Ekiplerin ilk inşa ettiği dört şey.

her biri tek bir uç nokta ve bir proje belirtecidir · hiçbiri bir öğleden sonranızı almaz

birleştirme kapısı · tek iş akışı dosyası

Bir çeviri başarısız olduğunda çekme isteğini kırmızıya çevirin.

zamanlanmış görev · her gece

Sürüm notlarını her gece, gece boyunca çevirin.

bot · tek abonelik

Bir toplu iş bittiği anda Slack'te paylaşın.

ajan · mcp

Bir yapay zeka asistanına sizin sahip olduğunuz aynı 17 aracı verin.

dakikada istek

hesap başına değil, belirteç başına; her 429 yanıtında kaç saniye bekleneceğini belirten bir Retry-After üst bilgisiyle.

dosya biçimleri

deponuzun zaten kullandığı biçimi gönderin ve çekin. Çoğullar ve yer tutucular her iki yönde de korunur. Her iki çağrıda da format= ile adlandırın.

webhook olayları

tüm katalog, her biri gerçek bir teslimatın taşıdığı kesin şekilde örnek bir yük içerir. GET /v1/webhooks/events.

mcp araçları

curl yerine bir ajan çalışma zamanına verilen aynı proje belirteci. npx -y @transglot/mcp.

SSS

Geliştiricilerin ilk istekten önce sorduğu sorular.

Transglot API ile kimlik doğrulamasını nasıl yaparım?

Bearer token gönderin: Authorization: Bearer $TRANSGLOT_TOKEN. Token tek bir projeye aittir, bu nedenle yol içinde proje kimliği bulunmaz ve hesap genelinde sızdırılabilecek bir anahtar yoktur. Tokenları proje sayfasında oluşturursunuz ve her biri kendi yetkilerini taşır: push, pull, manage, read, write.

API ücretsiz mi?

Hayır. Bearer token, aylık 19 $'dan başlayan Starter planıyla başlar. Ücretsiz sürüm, ürünün uygun olup olmadığını görmek için yeterli olan konsolu kapsar ancak token oluşturmaz. CLI, GitHub Action, web kancaları, MCP ve teslimat paketi aynı token arkasında yer alır, bu nedenle hepsi birlikte gelir.

Dizeleri Transglot'a nasıl yüklerim?

Dosya ve biçimiyle POST /v1/push yapın, örneğin -F "file=@lang/en.json" -F "format=laravel_json". 202 yanıtı verir ve bir toplu işlemi sıraya alır. Yalnızca gerçekten değişen satırlar çevrilir, bu nedenle değişmemiş bir dosyayı göndermek hiçbir maliyet yaratmaz.

Çevirilerimi nasıl geri alırım?

İstediğiniz zaman, 20 biçimin herhangi birinde GET /v1/pull yapın. Bu, CLI'nin sardığı ve API oyun alanının canlı çalıştırdığı uç noktadır. Dosyalanacak bir dışa aktarma isteği veya verinin size ait olmaktan çıktığı bir zaman penceresi yoktur.

API hız sınırı nedir?

Dakikada 60 istek, hesap başına değil token başına sayılır. Sınırı aşarsanız, kaç saniye beklemeniz gerektiğini belirten Retry-After üst bilgisiyle birlikte 429 alırsınız ve hiçbir ücret alınmaz veya yarım yazma işlemi gerçekleşmez. CI ve üretim için ayrı tokenlar kullanın; böylece gürültülü bir derleme uygulamanızı aç bırakamaz.

API hangi dilleri destekler?

Sabit bir liste yoktur. Doğrulayıcı, ICU'nun tanıdığı herhangi bir BCP-47 etiketini kabul eder; bu, kontrol ettiği tabloda 708 yerel ayar ve bunun dışındaki etiketler için yapısal bir yedek anlamına gelir. Projeye bir yerel ayar ekleyin, sonraki gönderimde o da dahil edilir.

Hangi dosya biçimlerini gönderebilir ve çekebilirim?

Yirmi: JSON düz ve iç içe, Laravel PHP ve JSON, Android XML, iOS .strings, .stringsdict ve .xcstrings, Flutter ARB, XLIFF 1.2 ve 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV ve Unreal PO. Yedisi çoğul yapılarını taşır ve dosya, girildiği şekliyle geri döner.

Transglot'un web kancaları var mı?

Evet. batch.completed, translation.reviewed, qa.completed ve source_drift.repaired dahil olmak üzere 12 web kanca olayı vardır. Her teslimat, doğrulamanızı sağlayan bir zaman damgası üst bilgisiyle HMAC ile imzalanır ve GET /v1/webhooks/events, her biri için örnek bir yük içeren kataloğu döndürür.

AI ajanları için bir MCP sunucusu var mı?

Evet. npx -y @transglot/mcp, proje jetonunuz üzerinden 17 araç sunar; böylece bir asistan çeviriyi okuyabilir, yazabilir, dil ekleyebilir, çalıştırma başlatabilir, toplu işlemi kontrol edebilir veya sözlüğü düzenleyebilir. Bu, curl yerine bir ajan çalışma zamanından erişilen aynı API ve aynı izinlerdir.

CI'da çalıştırabilir miyim?

Evet. GitHub Action (transglot/transglot-action@v1) ve CLI her ikisi de bu uç noktaları sarar. Bir satır reddedildiğinde, transglot push --wait 4 koduyla çıkar ve Action o çalıştırmadaki işini başarısız sayar. Bir birleştirmeyi durdurmak için, bunu çekme isteklerinde çalıştırın, commit girişini none olarak ayarlayın, eksik anahtar içeren çekilmiş bir dosya olduğunda başarısız olan bir adım ekleyin ve işi dal korumasında zorunlu bir kontrol yapın.

Bir çeviri kalite kontrolünü geçtiğinde ne olur?

Dört deterministik kapı her satırı okur: yer tutucular, çoğul biçimler, sözlük terimleri ve uzunluk. Bozuk bir yer tutucu, eksik bir çoğul biçim veya yasaklı bir sözlük terimi tek bir otomatik düzeltici yeniden deneme alır ve hâlâ başarısız olursa satır yazılmak yerine reddedilir. Yalnızca uzunluk sınırını aşan bir satır reddedilmez, yazılır. GET /v1/batches/:id?include=failures, reddedilen satırları ve nedenlerini listeler.

API entegrasyonumu bozar mı?

Hayır. /v1 yalnızca uç noktalar ve yanıt alanları kazanır; zaten ayrıştırdığınız bir alanın yapısı değişmez veya kaybolmaz. Bozucu bir değişiklik, ayrılmış ve henüz boş olan yeni bir sürüm öneki altında yayınlanırdı. API değişiklik günlüğü her sürümü kaydeder.