Tölts fel egy fájlt. Kapd vissza minden nyelven.

Küldjön bearer tokent: Authorization: Bearer $TRANSGLOT_TOKEN. A token egy projekthez tartozik, így nincs project id az útvonalban, és nincs fiókszintű kulcs, amely kiszivároghatna. A tokeneket a projekt oldalon hozhatja létre, és mindegyik saját jogosultságokkal rendelkezik: push, pull, manage, read, write.

Nem. A bearer token a Starter csomaggal indul havi 19 USD-ért. Az ingyenes verzió lefedi a konzolt, ami elegendő annak megállapításához, hogy a termék megfelel-e az igényeinek, de nem lehetővé token generálását. A CLI, a GitHub Action, a webhorgok, az MCP és a kézbesítési csomag ugyanazon a tokenen keresztül érhető el, így ezek együtt válnak elérhetővé.

POST /v1/push a fájllal és formátumával, például -F "file=@lang/en.json" -F "format=laravel_json". A válasz 202, és sorba állít egy köteget. Csak a ténylegesen módosult sorok kerülnek fordításra, így egy változatlan fájl feltöltése semmibe sem kerül.

GET /v1/pull, bármelyik 20 formátumban, amikor csak szeretné. Ez az végpont, amelyet a CLI burkol, és amelyet az API playground élőben futtat. Nincs exportkérés fájlba, és nincs olyan időszak, amikor az adatok ne lennének az Önéi.

Percenként 60 kérés, tokennként számítva, nem fiókonként. Túllépés esetén 429-es hibakódot kap egy Retry-After fejléccel, amely jelzi, hány másodpercet kell várni, és semmi sem kerül felszámításra vagy írásra félig. Adjon külön tokeneket a CI-nek és a production környezetnek, így egy zajos build nem éheztetheti ki az alkalmazást.

Nincs rögzített lista. A validátor elfogad bármilyen BCP-47 címkét, amelyet az ICU felismer, ami 708 locale-t jelent a táblázatban, plusz strukturális tartalékot a táblázaton kívüli címkékhez. Adjon hozzá egy locale-t a projekthez, és a következő push már tartalmazni fogja.

Húsz: JSON lapos és beágyazott, Laravel PHP és JSON, Android XML, iOS .strings, .stringsdict és .xcstrings, Flutter ARB, XLIFF 1.2 és 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV és Unreal PO. Hét formátum támogatja a többes számot, és a fájl ugyanabban a szerkezetben érkezik vissza, ahogy feltöltötték.

Igen. 12 webhook esemény létezik, beleértve a batch.completed, translation.reviewed, qa.completed és source_drift.repaired eseményeket. Minden kézbesítés HMAC aláírással és időbélyeg fejléccel rendelkezik az ellenőrzéshez, a GET /v1/webhooks/events pedig visszaadja a katalógust minden egyes minta payloaddal.

Igen. Az npx -y @transglot/mcp 17 eszközt tesz elérhetővé a projekt tokenjén keresztül, így egy asszisztens képes olvasni egy fordítást, írni egyet, nyelvet hozzáadni, futtatást indítani, köteget ellenőrizni vagy a szójegyzéket szerkeszteni. Ez ugyanaz az API és ugyanazok a jogosultságok, csak egy ügynök futtatókörnyezetből érhető el curl helyett.

Igen. A GitHub Action (transglot/transglot-action@v1) és a CLI is ezeket a végpontokat csomagolja be. Ha egy sor elutasításra kerül, a transglot push --wait 4-es kilépési kóddal tér vissza, és az Action sikertelennek jelöli a feladatot az adott futtatásban. Az egyesítés leállításához futtassa pull requesteken úgy, hogy a commit bemenetet none-ra állítja, adjon hozzá egy lépést, amely sikertelen, ha egy lekért fájlból hiányzik egy kulcs, és tegye a feladatot kötelező ellenőrzéssé az ágvédelemben.

Négy determinisztikus kapu olvassa végig minden sort: helyőrzők, többes számok, szójegyzék kifejezések és hosszúság. Egy hibás helyőrző, egy hiányzó többes alak vagy egy tiltott szójegyzék-kifejezés esetén egy automatikus javító újrapróbálkozás történik, és ha ez is sikertelen, a sort elutasítjuk ahelyett, hogy kiírnánk. Az a sor, amely csak a hosszúsági korlátot lépi túl, kiírásra kerül, nem utasítjuk el. A GET /v1/batches/:id?include=failures kilistázza az elutasított sorokat és azok okát.

Nem. A /v1 csak új végpontokat és válaszmezőket kap; egy már parse-olt mező nem változtatja meg a szerkezetét és nem tűnik el. Egy törést okozó változás új verzió előtag alatt jelenne meg, amely fenntartott és még üres. Az API changelog minden kiadást rögzít.