added
A deploy-key modell, ahol a bearer token maga a projekt. Ezen fut a CLI és a GitHub Action is.
api v1 · aktuális
Az API változásnaplója.
Semmi sem került eltávolításra.
A /v1 csak bővül. Új végpontok és új válaszmezők ugyanazon az előtagon belül jelennek meg, és egy már elemzett mező sosem változtatja meg a szerkezetét, és nem is tűnik el. Egy törést okozó változás egy új verzióelőtag alatt kerülne kiadásra, amely fenntartott és még üres.
v1/api/v1
az egyetlen használatban lévő előtag
az egyetlen használatban lévő előtag
5 kiadás
11 változás, egyik sem okoz törést
a napló felépítése
Egy verzióelőtag, eltávolítások nélkül.
Ebből a négyből három ennek a naplónak a tulajdonsága. A negyedik pedig az API által kiszolgált webhook-katalógus mérete.
5
kiadások a /v1-en, mindegyik bővítő jellegű
1
használatban lévő verzióelőtag. A következő fenntartott és üres
0
törést okozó változások az API kiadása óta
12
aláírt webhook események. Forrás: App\Enums\WebhookEvent
dátumozva kiadás szerint, nem szemantikus verzió szerint
használd a nyílbillentyűket a navigáláshoz
2026-07-08
CDN kézbesítés, használatmérés és a playground
July 8, 2026 · 4 módosítás
05 / 05
added
A /v1/incontext/translations, /screenshots és /suggest végpontok vezérlik a vizuális szerkesztőt, a CORS csak erre az előtagra van korlátozva, semmi másra.
A POST /v1/incontext/session egy közzétehető kulcsot és egy Origin-t cserél le egy scope-olt munkamenet-tokenre.
improved
A kétnyelvű export most jelenteni tudja, mit nem sikerült körkörösen visszaadni, ahelyett, hogy csendben behelyettesítené a forrásszöveget. A meglévő mezők változatlanok maradnak – ez a lényege annak, hogy fejlécben jelenik meg.
A GET /v1/pull megkapta az X-Skipped-Keys és X-Missing-Source-Keys válaszfejléceket.
added
Plusz /v1/glossary/import, /export és /extract, így a szóbázis áthelyezhető be és ki anélkül, hogy meg kellene nyitni a konzolt.
Teljes szóbázis CRUD az API-n keresztül: GET, POST, PUT és DELETE a /v1/glossary végponton.
added
A találatok megjelennek a már lekért fordítási sorokon, így nincs szükség újabb pollolásra.
A POST /v1/qa/run elindít egy ügynök alapú minőségellenőrzést, és visszaadja a futtatás azonosítóját.
added
Feliratkozás végpontonként. A lista maga az App\Enums\WebhookEvent-ben található, amely ma tizenkét esetet tartalmaz; számold meg az enumot, ne ezt a sort.
Az aláírt webhookok kulcs-, fordítás-, nyelv-, szójegyzék- és QA-eseményeket bocsátanak ki az eredeti batch páros mellett.
improved
A kézbesítés egy darabszámot és legfeljebb húsz mintát tartalmaz, nem pedig egy hívást minden módosított sorhoz. A kézbesítési naplók minden kísérletet rögzítenek a következő újrapróbálkozás idejével együtt.
A nagy gyakoriságú események, mint például a translation.updated, egyetlen kézbesítésbe vannak összevonva egy ablak alatt, így egy tömeges szerkesztés soha nem árasztja el a végpontot.
added
ETag-et és rövid élettartamú gyorsítótárat ad vissza, valamint tiszteli az If-None-Match feltételt 304-gyel. A /v{n} alatti immutable testvér tartalomcímezett, és egy évig gyorsítótárazott.
Egy nyilvános, edge-cache-elhető GET /v1/cdn/{project}/{locale} végpont szolgálja ki a közzétett karakterláncaidat.
added
Indítsd el CI-ben a POST /v1/cdn/publish segítségével, és engedélyezd az olvasást egy dedikált, csak olvasható kulccsal az X-Transglot-Cdn-Key fejlécben. Biztonságosan helyezhető saját CDN mögé.
A közzététel promóciója az aktuális fordításokat egy új, immutable verzióba emeli, manuálisan vagy minden push alkalmával.
added
Nem tárolunk kéréstörzseket. Ez csak egy számláló, semmi más.
Minden hitelesített /v1 hívást naponta tokenenként számolunk, és megjelenítünk a deploy hubon.
improved
Projekt, lekérés, kötegek és szójegyzék exportálása. A működéshez nem változott meg a kérések vagy válaszok formátuma.
A telepítési központ egy API-játékteret kapott, amely élőben futtatja a csak olvasható végpontokat a projektjén.
elavulási regiszter
Semmi sem tűnik el.
Egy sor minden közzétett felülethez, a kiadással, amely tartalmazta. Az utolsó oszlop a figyelemre méltó: az eltávolítás ott jelenne meg egy dátummal jóval a bekövetkezte előtt.
| Felület | Kiadva | Állapot | Eltávolítás dátuma |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | aktuális | nincs ütemezve |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | aktuális | nincs ütemezve |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | aktuális | nincs ütemezve |
POST /v1/qa/run | June 12, 2026 | aktuális | nincs ütemezve |
Signed webhook events, twelve typed cases | June 30, 2026 | aktuális | nincs ütemezve |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | aktuális | nincs ütemezve |
Egy sort soha nem törölnek ebből a táblázatból. Ha egy felületet visszavonnak, megmarad a sora, és kap egy dátumot, mert a tervezhető eltávolítás a közzététel lényege.
a kompatibilitási garancia
Három szabály amire építhet.
bővítő jellegű
Új végpontok és új válaszmezők kerülnek bevezetésre a /v1 alatt. Egy már általad feldolgozott mező szerkezete nem változik, és nem tűnik el.
új előtag
Egy törést okozó változtatás egy új verzióelőtag alatt kerülne bevezetésre, nem pedig ezen belül. Ez az előtag le van foglalva és használaton kívül van, minden kiadás a v1-en alapul.
őszinte fejlécek
Amikor egy lekérés nem képes valamit hibátlanul továbbítani, azt egy fejlécben jelzi. Az X-Skipped-Keys és X-Missing-Source-Keys hozzáadása történt ahelyett, hogy a törzs megváltozna a háttérben.
GYIK
Amit a fejlesztők kérdeznek az API-verziókezelésről és a kivonásról.
Verziókezelt a Transglot API?
Igen, URL-előtag alapján. Minden eddig közzétett elem a /v1 alatt érhető el, ez az egyetlen használatban lévő előtag. Nincs verziófejléc, nincs dátumhoz rögzítés, és semmit sem kell konfigurálni.
Egy frissítés valaha is megtörheti az integrációmat?
Nem a /v1-en belül. Új végpontok és új válaszmezők kerülnek hozzáadásra, de egy már általad feldolgozott mező szerkezete nem változik, és nem tűnik el. Ha egy változtatást nem lehet bővítő jelleggel végrehajtani, akkor egy új előtag alatt történik, a régi pedig tovább működik.
Bármi is lett kivonva vagy eltávolítva?
Semmi, és a fenti nyilvántartás soronként ezt igazolja. Minden közzétett felület fel van sorolva a kiadással, amely bevezette, valamint egy eltávolítási oszloppal, amely jelenleg végig „nincs tervezve” értéket mutat.
Mennyi előzetes értesítést kapnék egy eltávolítás esetén?
Egy eltávolítás megjelenne abban a nyilvántartásban egy dátummal jóval a bekövetkezte előtt, és a sor megmaradna a táblázatban utána is, ahelyett, hogy eltűnne. Egy tervezhető dátum adása a teljes célja a közzétételnek.
Honnan tudom, mikor jelenik meg valami új?
Minden kiadás dátummal van ellátva ezen az oldalon. A termék naplója minden egyéb megjelenést lefed, a konzol pedig jelöléssel látja el azokat, amelyeket még nem olvastál.
Miért van külön napló az API-hoz?
Mert az API kompatibilitási garanciát vállal, amit egy termékkiadás nem. Egy fejlesztőnek, aki azt ellenőrzi, hogy egy integráció még mindig működik-e, nem kell végiggörgetnie a funkciófejlesztéseket, hogy ezt megtudja.
Hogyan adhatom hozzá az API-t a csomagomhoz?
A bearer token a Starter csomaggal indul, havi 19 USD áron. Az ingyenes csomag lefedi a konzolt, de nem lehetővé token létrehozását; a CLI, a GitHub Action, a webhorgok és az MCP mind ehhez a tokenhez kötődnek.
Hol található maga az endpointok referencia dokumentációja?
Az API oldalon: hitelesítés, endpointok, sebességkorlát, fájlformátumok és a webhook katalógus. Ez az oldal csak a változások és azok időpontjának nyilvántartása.
működik azokkal az eszközökkel, amelyeket már használ
41 connectors, already built.
a szerződés maga a termék
Építs API-ra ami nem mozdul.
Az API a Starter és afölötti csomagokban érhető el. Az Ingyenes csomag 0 USD, kezdésnek 100 000 szóval (25 000 regisztrációkor, 75 000 telefonos ellenőrzés után), havi 10 000 szóval ezután, és nincs API vagy webhook hozzáférés.