api.transglot.ai/v1token bearer, un proiectreferință

Încarcă un fișier. Obține toate limbile înapoi.

Un API REST pentru traducerea aplicației tale. Un singur POST încarcă fișierul sursă, un singur GET returnează o localizare finalizată, iar un token bearer reprezintă întreaga autentificare. Orice sistem care comunică prin HTTP îl poate utiliza.

în: un apel

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

ieșire

300,000

cuvinte pe lună pe planul Starter, primul plan care poate genera un token.

Începe gratuit Vezi interfața pentru dezvoltatori

60 de cereri pe minut per token · fiecare eroare 429 include un antet Retry-After · folosește token-uri separate pentru CI și producție

consola este un client API

Încarcă, traduce, verifică și descarcă, fiecare fiind un endpoint REST.

Fiecare rând din imaginea de mai jos are o rută asociată: încărcare, verificări, glosar, loturi și descărcare, toate accesibile din propriul cod cu un token de proiect. Zona de testare API din consolă rulează live operațiunile de citire împotriva proiectului tău, astfel încât vezi mai întâi un răspuns real.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Încarci un fișier sursă
POST/v1/push
Panoul de verificări se completează
POST/v1/qa/run
Blochezi un termen
POST/v1/glossary
Vizualizarea loturilor se actualizează automat
GET/v1/batches/:id
Recuperezi traducerile
GET/v1/pull

o rută per panou, 60 pe minut, abilități per token · exportul traducerilor este și el un endpoint

este doar HTTP

Patru lucruri pe care echipele le construiesc primele.

fiecare este un singur endpoint și un token de proiect · niciunul nu necesită o după-amiază întreagă

poartă de îmbinare · un singur fișier de flux de lucru

Marchează pull request-ul ca eșuat când o traducere nu trece.

cron · nightly

Traduce notele de lansare peste noapte, în fiecare noapte.

bot · o singură abonare

Postează în Slack imediat ce un lot se finalizează.

agent · MCP

Oferă unui agent AI aceleași 17 instrumente pe care le ai tu.

cereri pe minut

per token, nu per cont, cu un antet Retry-After la fiecare 429 care indică câte secunde să aștepți.

formate de fișier

importă și exportă în formatul pe care îl folosește deja repository-ul tău. Pluralele și placeholder-ele sunt păstrate în ambele direcții. Specifică-l cu format= în orice apel.

evenimente webhook

întregul catalog, fiecare cu un exemplu de payload în exact forma unei livrări reale. GET /v1/webhooks/events.

instrumente MCP

același token de proiect, transmis unui runtime de agent în loc de curl. npx -y @transglot/mcp.

Întrebări frecvente

Ce întreabă dezvoltatorii înainte de prima solicitare.

Cum mă autentific la API-ul Transglot?

Trimite un token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. Token-ul aparține unui singur proiect, deci nu există un ID de proiect în cale și nici o cheie la nivel de cont care să fie expusă. Creezi token-uri pe pagina proiectului și fiecare are propriile abilități: push, pull, manage, read, write.

API-ul este gratuit?

Nu. Un token bearer începe de la planul Starter, la 19 USD pe lună. Planul gratuit acoperă consola, suficientă pentru a vedea dacă produsul se potrivește nevoilor tale, dar nu permite generarea unui token. CLI, GitHub Action, webhook-urile, MCP și pachetul de livrare sunt toate accesibile prin același token, deci sunt disponibile împreună.

Cum încarc șirurile în Transglot?

POST /v1/push cu fișierul și formatul său, de exemplu -F "file=@lang/en.json" -F "format=laravel_json". Răspunde cu 202 și adaugă un lot în coadă. Sunt traduse doar rândurile care s-au schimbat efectiv, deci încărcarea unui fișier nemodificat nu costă nimic.

Cum recuperez traducerile?

GET /v1/pull, în oricare dintre cele 20 de formate, oricând dorești. Este endpoint-ul pe care îl încapsulează CLI-ul și cel pe care rulează live zona de test API. Nu există o cerere de export către fișier și niciun interval în care datele să nu mai fie ale tale.

Care este limita de rate a API-ului?

60 de cereri pe minut, calculate per token, nu per cont. Dacă depășești limita, primești un cod 429 cu un antet Retry-After care indică câte secunde să aștepți, iar nimic nu se facturează sau se scrie parțial. Folosește token-uri separate pentru CI și producție, astfel încât o build zgomotoasă să nu blocheze aplicația ta.

Ce limbi suportă API-ul?

Nu există o listă fixă. Validatorul acceptă orice etichetă BCP-47 recunoscută de ICU, adică 708 de locale din tabelul față de care verifică, plus un fallback structural pentru etichetele din afara acestuia. Adaugă un locale la proiect, iar următorul push îl va include.

Ce formate de fișiere pot trimite și descărca?

Douăzeci: JSON plat și imbricat, Laravel PHP și JSON, Android XML, iOS .strings, .stringsdict și .xcstrings, Flutter ARB, XLIFF 1.2 și 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV și Unreal PO. Șapte dintre ele suportă pluraluri, iar fișierul revine în aceeași structură în care a fost trimis.

Transglot are webhook-uri?

Da. Există 12 evenimente de webhook, inclusiv batch.completed, translation.reviewed, qa.completed și source_drift.repaired. Fiecare livrare este semnată HMAC cu un antet de timestamp, astfel încât să o poți verifica, iar GET /v1/webhooks/events returnează catalogul cu un payload exemplu pentru fiecare.

Există un server MCP pentru agenți AI?

Da. npx -y @transglot/mcp expune 17 instrumente prin token-ul proiectului tău, astfel încât un asistent poate citi o traducere, poate scrie una, poate adăuga o limbă, poate porni o execuție, poate verifica un lot sau poate edita glosarul. Este același API și aceleași permisiuni, accesate dintr-un mediu de rulare pentru agenți în loc de curl.

Îl pot rula în CI?

Da. Acțiunea GitHub (transglot/transglot-action@v1) și CLI înfășoară aceste puncte finale. Când un rând este refuzat, transglot push --wait se termină cu codul 4, iar acțiunea eșuează pentru acea execuție. Pentru a opri o îmbinare, ruleaz-o pe pull request-uri cu intrarea commit setată la none, adaugă un pas care eșuează când unui fișier extras îi lipsește o cheie și fă ca jobul să fie o verificare obligatorie în protecția ramurii.

Ce se întâmplă când o traducere eșuează la o verificare de calitate?

Patru porți deterministe verifică fiecare rând: substituenți, plurale, termeni din glosar și lungime. Un substituent defect, o formă de plural lipsă sau un termen interzis din glosar declanșează o singură reîncercare corectivă automată; dacă tot eșuează, rândul este refuzat în loc să fie scris. Un rând care depășește doar limita de lungime este scris, nu refuzat. GET /v1/batches/:id?include=failures listează rândurile refuzate și motivul.

Va strica API-ul vreodată integrarea mea?

Nu. /v1 adaugă doar endpoint-uri și câmpuri de răspuns; un câmp pe care îl parsezi deja nu își schimbă structura și nu dispare. O modificare care ar strica compatibilitatea ar fi lansată sub un nou prefix de versiune, care este rezervat și încă gol. Jurnalul de modificări API înregistrează fiecare lansare.