added
Deploy-avainmalli, jossa bearer-token ON projekti. Sitä käyttävät sekä CLI että GitHub Action.
api v1 · nykyinen
API:n muutosloki.
Ei poistoja.
/v1 saa ainoastaan uusia ominaisuuksia. Uudet päätepisteet ja vastauskentät lisätään saman etuliitteen alle, eikä jo parsittu kenttä koskaan muuta muotoaan tai katoa. Yhteensopimattomuuden aiheuttava muutos julkaistaisiin uuden version etuliitteen alla, joka on varattu ja edelleen tyhjä.
v1/api/v1
ainoa käytössä oleva etuliite
ainoa käytössä oleva etuliite
5 julkaisua
11 muutosta, ei yhtään yhteensopimattomuutta
lokin rakenne
Yksi version etuliite, ei poistoja.
Kolme näistä neljästä on tämän lokin ominaisuuksia. Neljäs on API:n tarjoaman webhook-katalogin koko.
5
julkaisut /v1:ssä, kaikki laajentavia
1
version etuliite käytössä. Seuraava on varattu ja tyhjä
0
yhteensopimattomat muutokset API:n julkaisun jälkeen
12
allekirjoitetut webhook-tapahtumat. Lähde: App\Enums\WebhookEvent
päivämäärät julkaisun, ei semverin mukaan
käytä nuolinäppäimiä navigointiin
2026-07-08
CDN-toimitus, käyttö ja pelikenttä
July 8, 2026 · 4 muutosta
05 / 05
added
/v1/incontext/translations, /screenshots ja /suggest ohjaavat visuaalista editoria, ja CORS on rajattu tähän etuliitteeseen eikä mihinkään muuhun.
POST /v1/incontext/session vaihtaa julkisen avaimen ja Origin-arvon rajattuun istuntotokeniin.
improved
Kaksikielinen vienti ilmoittaa nyt, mitä se ei pystynyt kiertämään takaisin, sen sijaan että korvaisi lähdetekstin hiljaa. Olemassa olevat kentät pysyvät ennallaan, mikä on koko pointti otsakkeen käytölle.
GET /v1/pull sai X-Skipped-Keys- ja X-Missing-Source-Keys-vastausotsakkeet.
added
Lisäksi /v1/glossary/import, /export ja /extract, jotta termipankki voidaan siirtää sisään ja ulos avaamatta konsolia.
Täysi termipankin CRUD API:n kautta: GET, POST, PUT ja DELETE osoitteessa /v1/glossary.
added
Löydökset ilmestyvät jo noutamiisi käännösriveihin, joten mitään uutta ei tarvitse pollata.
POST /v1/qa/run käynnistää agenttisen laadunvalvonnan ja palauttaa ajon tunnisteen.
added
Tilaa päätepisteittäin. Lista itsessään on App\Enums\WebhookEvent-luokassa, jossa on tällä hetkellä kaksitoista tapausta; laske enum eikä tätä riviä.
Allekirjoitetut webhookit lähettävät avain-, käännös-, kieli-, sanasto- ja QA-tapahtumia alkuperäisen eräparin rinnalla.
improved
Toimitus sisältää määrän ja enintään kaksikymmentä näytettä yhden kutsun sijaan muutettua riviä kohti. Toimituslogit tallentavat jokaisen yrityksen seuraavan uudelleenyrityksen ajan kanssa.
Usein toistuvat tapahtumat, kuten translation.updated, yhdistetään yhdeksi toimitukseksi aikavälillä, joten joukkomuokkaus ei tulvita päätepistettä.
added
Se palauttaa ETagin ja lyhytaikaisen välimuistin sekä kunnioittaa If-None-Match -otsaketta 304-vastauksella. Polun /v{n} alla oleva muuttumaton sisarus on sisältöosoitteinen ja se on välimuistissa vuoden ajan.
Julkinen, reunavälimuistiin sopiva GET /v1/cdn/{project}/{locale} tarjoaa julkaistut merkkijonosi.
added
Käynnistä se CI:ssä komennolla POST /v1/cdn/publish ja valtuuta lukuoikeudet omalla vain luku -avaimella X-Transglot-Cdn-Key-otsakkeessa. Turvallista sijoittaa oman CDN:n taakse.
Julkaisu ylennetään nykyiset käännökset uuteen muuttumattomaan versioon, manuaalisesti tai jokaisella pushilla.
added
Pyyntöjen runkoja ei tallenneta. Se on pelkkä laskuri, ei mitään muuta.
Jokainen todennettu /v1-kutsu lasketaan tokenia kohden päivässä ja näytetään deploy hubissa.
improved
Projekti, veto, erät ja sanaston vienti. Pyyntöjen tai vastausten muotoa ei muutettu sen toimimiseksi.
Deploy hub sai API-pelikentän, joka ajaa live-tilassa vain luku -päätepisteitä projektiasi vasten.
poistorekisteri
Mikään ei ole katoamassa.
Yksi rivi kutakin julkaistua pintaa kohden, julkaisun kanssa, joka toimitti sen. Viimeinen sarake on se, jota kannattaa seurata: poisto näkyisi siinä päivämäärän kera kauan ennen kuin se tapahtuisi.
| Pinta | Toimitettu | Tila | Poistopäivä |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | nykyinen | ei ajoitettuja |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | nykyinen | ei ajoitettuja |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | nykyinen | ei ajoitettuja |
POST /v1/qa/run | June 12, 2026 | nykyinen | ei ajoitettuja |
Signed webhook events, twelve typed cases | June 30, 2026 | nykyinen | ei ajoitettuja |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | nykyinen | ei ajoitettuja |
Riviä ei koskaan poisteta tästä taulukosta. Jos pinta poistetaan käytöstä, se säilyttää rivinsä ja saa päivämäärän, sillä suunniteltavissa oleva poisto on koko julkaisemisen tarkoitus.
yhteensopivuuslupaus
Kolme sääntöä johon voit rakentaa.
lisäävä
Uudet päätepisteet ja vastauskentät toimitetaan osana /v1:tä. Kenttä, jota jo jäsentät, ei muuta muotoaan eikä katoa.
uusi etuliite
Yhteensopimattomuus muutoksena toimitettaisiin uuden version etuliitteen alla tämän sijaan. Kyseinen etuliite on varattu ja käyttämätön, ja kaikki sitä myöhemmät julkaisut ovat olleet v1:ssä.
rehelliset otsakkeet
Kun pull ei voi kiertää jotakin, se ilmoittaa siitä otsikossa. X-Skipped-Keys ja X-Missing-Source-Keys lisättiin sen sijaan, että sisältöä olisi muutettu yllättäen.
UKK
Mitä kehittäjät kysyvät API:n versiointiin ja poistamisesta.
Onko Transglot API versioitu?
Kyllä, URL-osoitteen etuliitteen perusteella. Kaikki tähän mennessä julkaistu on /v1-polun alla, joka on ainoa käytössä oleva etuliite. Versio-otsikkoa, päivämäärän kiinnitystä tai muita asetuksia ei ole.
Rikkooko päivitys joskus integraationi?
Ei /v1:ssä. Uusia päätepisteitä ja vastauskenttiä lisätään, mutta jo parsimasi kenttä ei muuta muotoaan eikä katoa. Jos muutos ei ole mahdollista tehdä lisäten, se tehdään uuden etuliitteen alle, ja vanha jatkaa toimintaansa.
Onko mitään merkitty vanhentuneeksi tai poistettu?
Ei mitään, ja yllä oleva rekisteri kertoo sen rivittäin. Jokainen julkaistu rajapinta on lueteltu julkaisun kanssa, joka toi sen käyttöön, ja poistosarakkeessa lukee ”ei suunniteltu” koko listan ajan.
Kuinka paljon ennakkovaroitusta poistosta annetaan?
Poisto näkyisi rekisterissä päivämäärällä varustettuna kauan ennen toteutumista, ja rivi pysyisi taulukossa myös jälkeenpäin sen sijaan, että se katoaisi. Suunniteltavissa oleva päivämäärä on koko julkaisemisen pointti.
Miten tiedän, kun jotain uutta julkaistaan?
Jokainen julkaisu on päivätty tällä sivulla. Tuotteen muutosloki kattaa kaiken muun julkaistavan, ja konsoli näyttää merkin, kun siellä on lukematonta.
Miksi API:lle on erillinen muutosloki?
Koska API:n yhteensopivuuslupaus eroaa tuotejulkaisusta. Kehittäjän, joka tarkistaa integraation toimivuuden, ei pitäisi joutua selaamaan ominaisuuspäivitysten läpi löytääkseen tiedon.
Miten lisään API:n tilaukseeni?
Bearer-token alkaa Starter-suunnitelmasta hintaan 19 $ kuukaudessa. Ilmainen versio kattaa konsolin, mutta ei mahdollista tokenin luomista, ja CLI, GitHub Action, webhookit sekä MCP ovat kaikki tämän saman tokenin takana.
Mistä löydän itse päätepisteiden viitedokumentation?
API-sivulla: todennus, päätepisteet, nopeusrajoitukset, tiedostomuodot ja webhook-luettelo. Tämä sivu on vain luettelo muutoksista ja niiden ajankohdista.
toimii jo käyttämiesi työkalujen kanssa
41 liitintä, valmiina.
sopimus on tuote
Rakenna API:n päälle joka ei muutu.
API on saatavilla Starter-paketista ylöspäin. Ilmainen taso maksaa 0 $ ja sisältää aluksi 100 000 sanaa (25 000 rekisteröityessä, 75 000 puhelinvarmistuksen jälkeen), tämän jälkeen 10 000 sanaa kuukaudessa, eikä sisällä API- tai webhook-toimintoja.