added
Modelul cu cheie de deploy, unde tokenul bearer ESTE proiectul. Este ceea ce rulează atât CLI, cât și GitHub Action.
api v1 · curent
Jurnalul de modificări API.
Nimic eliminat.
/v1 doar adaugă funcționalități. Noile endpoint-uri și câmpurile de răspuns noi apar sub același prefix, iar un câmp pe care îl procesezi deja nu își schimbă structura și nu dispare. O modificare incompatibilă ar fi lansată sub un nou prefix de versiune, care este rezervat și încă gol.
v1/api/v1
singurul prefix în uz
singurul prefix în uz
5 lansări
11 modificări, niciuna incompatibilă
structura jurnalului
Un singur prefix de versiune, fără eliminări.
Trei dintre aceste patru sunt proprietăți ale acestui jurnal în sine. A patra este dimensiunea catalogului de webhook-uri oferit de API.
5
lansări pe /v1, fiecare fiind aditivă
1
prefix de versiune în uz. Următorul este rezervat și gol
0
modificări incompatibile de la lansarea API-ului
12
evenimente webhook semnate. Sursă: App\Enums\WebhookEvent
datate după lansare, nu după semver
folosește tastele săgeți pentru a naviga
2026-07-08
Livrare CDN, utilizare și zona de testare
July 8, 2026 · 4 modificări
05 / 05
added
/v1/incontext/translations, /screenshots și /suggest alimentează editorul vizual, cu CORS limitat la acel prefix și nimic altceva.
POST /v1/incontext/session schimbă o cheie publicabilă și un Origin pentru un token de sesiune cu scop limitat.
improved
Un export bilingv raportează acum ceea ce nu a putut fi convertit complet, în loc să substituie silențios textul sursă. Câmpurile existente rămân nemodificate, ceea ce este scopul principal al plasării lor într-un antet.
GET /v1/pull a primit antetele de răspuns X-Skipped-Keys și X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export și /extract, astfel încât o bază de termeni poate fi importată și exportată fără a deschide consola.
CRUD complet pentru baza de termeni prin API: GET, POST, PUT și DELETE pe /v1/glossary.
added
Rezultatele apar în rândurile de traducere pe care le preiați deja, deci nu trebuie să interogați nimic nou.
POST /v1/qa/run declanșează o verificare agentică a calității și returnează identificatorul rulării.
added
Abonați-vă per endpoint. Lista în sine se află în App\Enums\WebhookEvent, care conține astăzi douăsprezece cazuri; numărați enum-ul, nu această linie.
Webhook-urile semnate emit evenimente pentru chei, traduceri, limbi, glosare și QA alături de perechea originală din lot.
improved
Livrarea include un contor și până la douăzeci de exemple, în loc de câte un apel pentru fiecare rând modificat. Jurnalele de livrare înregistrează fiecare încercare cu momentul următoarei reîncercări.
Evenimentele cu frecvență ridicată, precum translation.updated, sunt agregate într-o singură livrare pe interval, astfel încât o editare în masă nu inundă niciodată un endpoint.
added
Returnează un ETag și un cache cu durată scurtă de viață și respectă If-None-Match cu un 304. Varianta imutabilă de sub /v{n} este adresată după conținut și stocată în cache timp de un an.
Un GET public, cache-abil la marginea rețelei, /v1/cdn/{project}/{locale}, servește șirurile publicate.
added
Declanșați-l în CI cu POST /v1/cdn/publish și autorizați citirile cu o cheie dedicată, read-only, în antetul X-Transglot-Cdn-Key. Sigur de plasat în spatele unui CDN propriu.
Publicarea promovează traducerile curente într-o nouă versiune imutabilă, manual sau la fiecare push.
added
Nu se stochează corpuri de cereri. Este doar un contor și nimic altceva.
Fiecare apel autentificat /v1 este numărat per token pe zi și afișat în hub-ul de implementare.
improved
Proiect, pull, loturi și export glosar. Niciun format de cerere sau răspuns nu s-a schimbat pentru a funcționa.
Hub-ul de implementare a câștigat o zonă de testare API care rulează endpoint-uri read-only live împotriva proiectului dvs.
registru de depreciere
Nimic nu este eliminat.
Un rând per suprafață publicată, cu lansarea care a inclus-o. Ultima coloană este cea de urmărit: o eliminare ar apărea acolo cu o dată mult înainte ca aceasta să aibă loc.
| Suprafață | Lansat | Stare | Data eliminării |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | actual | niciunul programat |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | actual | niciunul programat |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | actual | niciunul programat |
POST /v1/qa/run | June 12, 2026 | actual | niciunul programat |
Signed webhook events, twelve typed cases | June 30, 2026 | actual | niciunul programat |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | actual | niciunul programat |
Un rând nu este niciodată șters din acest tabel. Dacă o suprafață este retrasă, își păstrează rândul și primește o dată, deoarece posibilitatea de a planifica o eliminare este scopul principal al publicării acesteia.
promisiunea de compatibilitate
Trei reguli pe care puteți construi.
aditiv
Noi puncte finale și noi câmpuri de răspuns sunt lansate în cadrul /v1. Un câmp pe care îl analizați deja nu își schimbă structura și nu dispare.
prefix nou
O modificare care rupe compatibilitatea ar fi lansată sub un prefix de versiune nou, nu în cadrul acestei versiuni. Acel prefix este rezervat și nefolosit, iar fiecare lansare ulterioară s-a bazat pe v1.
anteturi oneste
Când o solicitare nu poate procesa complet ceva, indică acest lucru într-un antet. X-Skipped-Keys și X-Missing-Source-Keys au fost adăugate în loc să se modifice corpul răspunsului.
Întrebări frecvente
Ce întreabă dezvoltatorii despre versionarea API-ului și eliminarea funcțiilor.
API-ul Transglot este versionat?
Da, prin prefixul URL. Tot ce a fost publicat până acum se află sub /v1, care este singurul prefix utilizat. Nu există un antet de versiune, nu există fixare pe dată și nimic de configurat.
Va afecta vreodată o actualizare integrarea mea?
Nu în cadrul /v1. Se adaugă puncte finale noi și câmpuri noi de răspuns, dar un câmp pe care îl analizați deja nu își schimbă structura și nu dispare. Dacă o modificare nu poate fi făcută aditiv, aceasta va fi plasată sub un nou prefix, iar cel vechi va continua să funcționeze.
A fost ceva eliminat sau scos din uz?
Nimic, iar registrul de mai sus confirmă acest lucru rând cu rând. Fiecare suprafață publicată este listată cu lansarea care a inclus-o și o coloană de eliminare care indică momentan „nicio programare” pe toată lista.
Cât preaviz s-ar acorda pentru o eliminare?
O eliminare ar apărea în acel registru cu o dată mult înainte de producerea ei, iar rândul ar rămâne în tabel după aceea, în loc să dispară. O dată la care vă puteți planifica este scopul principal al publicării acesteia.
Cum știu când este lansat ceva nou?
Fiecare lansare este datată pe această pagină. Jurnalul de modificări al produsului acoperă tot restul conținutului lansat, iar consola afișează un marker când există ceva ce nu ați citit.
De ce există un jurnal de modificări separat pentru API?
Pentru că API-ul include o promisiune de compatibilitate pe care o lansare de produs nu o include. Un dezvoltator care verifică dacă o integrare funcționează încă nu ar trebui să fie nevoit să deruleze peste lucrările de funcționalități pentru a afla.
Cum adaug API-ul la planul meu?
Un token bearer începe cu planul Starter la 19 USD pe lună. Planul gratuit acoperă consola, dar nu permite generarea unui token, iar CLI, GitHub Action, webhook-urile și MCP sunt toate protejate de același token.
Unde se află referința pentru punctele finale în sine?
Pe pagina API: autentificare, endpoint-urile, limita de rate, formatele de fișiere și catalogul de webhook-uri. Această pagină este doar un istoric al modificărilor și al momentelor în care au avut loc.
funcționează cu ceea ce folosiți deja
41 conectori, deja construiți.
contractul este produsul
Construiește pe baza unui API care nu se schimbă.
API-ul este disponibil pe planurile Starter și superioare. Planul gratuit costă 0 $ și include 100.000 de cuvinte la început (25.000 la înregistrare, 75.000 după verificarea telefonică), apoi 10.000 pe lună, fără acces la API sau webhook-uri.