added
Deploy-nøkkelmodellen, der bæretokenet ER prosjektet. Det er det både CLI-en og GitHub Action kjører på.
api v1 · gjeldende
API-endringsloggen.
Ingenting fjernet.
/v1 får bare nye funksjoner. Nye endepunkter og nye responsfelt legges til innenfor samme prefiks, og et felt du allerede parser endrer aldri form eller forsvinner. En ødeleggende endring vil leveres under et nytt versjonsprefiks, som er reservert og fortsatt tomt.
v1/api/v1
det eneste prefikset i bruk
det eneste prefikset i bruk
5 utgivelser
11 endringer, ingen av dem ødeleggende
loggens struktur
Ét versjonsprefiks, ingen fjerninger.
Tre av disse fire er egenskaper ved selve loggen. Den fjerde er størrelsen på webhook-katalogen API-et betjener.
5
utgivelser på /v1, alle additive
1
versjonsprefiks i bruk. Det neste er reservert og tomt
0
ødeleggende endringer siden API-et ble lansert
12
signerte webhook-hendelser. Kilde: App\Enums\WebhookEvent
datert etter utgivelse, ikke etter semver
bruk piltastene for å navigere
2026-07-08
CDN-levering, bruk og lekegrinden
July 8, 2026 · 4 endringer
05 / 05
added
/v1/incontext/translations, /screenshots og /suggest driver den visuelle editoren, med CORS skopet til dette prefikset og ingenting annet.
POST /v1/incontext/session bytter en publiserbar nøkkel og en Origin mot et skopet sesjonstoken.
improved
En tospråklig eksport rapporterer nå hva den ikke kunne round-tripe i stedet for stille å erstatte med kildetext. Eksisterende felt er uendret, noe som er hele poenget med å plassere det i en header.
GET /v1/pull fikk responsheadere X-Skipped-Keys og X-Missing-Source-Keys.
added
Pluss /v1/glossary/import, /export og /extract, slik at en termbase kan flyttes inn og ut uten å åpne konsollen.
Full CRUD for termbase via API: GET, POST, PUT og DELETE på /v1/glossary.
added
Funndetaljer havner på oversettelsesradene du allerede henter, så ingenting nytt må polles.
POST /v1/qa/run utløser en agentisk kvalitetssjekk og returnerer kjørehåndtaket.
added
Abonner per endepunkt. Listen finnes i App\Enums\WebhookEvent, som har tolv tilfeller i dag; tell oppramsingen i stedet for denne linjen.
Signerte webhooks sender ut hendelser for nøkkel, oversettelse, språk, ordliste og QA sammen med det opprinnelige batch-paret.
improved
Leveringen inneholder en telling og opptil tjue eksempler i stedet for ett kall per endret rad. Leveringslogger registrerer hvert forsøk med tidspunktet for neste nyforsøk.
Høyfrekvente hendelser som translation.updated slås sammen til én levering per vindu, slik at en masseoppdatering aldri oversvømmer et endepunkt.
added
Den returnerer en ETag og en kortvarig cache, og respekterer If-None-Match med en 304. Den immutable søsteren under /v{n} er innholdsadressert og bufret i ett år.
En offentlig, kantbufret GET /v1/cdn/{project}/{locale} leverer dine publiserte strenger.
added
Utløs den i CI med POST /v1/cdn/publish, og autoriser lesing med en dedikert skrivebeskyttet nøkkel i X-Transglot-Cdn-Key-headeren. Trygt å plassere bak din egen CDN.
Publisering fremmer gjeldende oversettelser til en ny immutable versjon, manuelt eller ved hver push.
added
Ingen forespørselskropper lagres. Det er kun en telling og ingenting annet.
Hvert autentisert /v1-kall telles per token per dag og vises på distribusjonsnavet.
improved
Prosjekt, pull, batcher og eksport av ordliste. Ingen form på forespørsel eller respons ble endret for å få det til å fungere.
Distribusjonsnavet fikk en API-lekegrind som kjører skrivebeskyttede endepunkter live mot prosjektet ditt.
avviklingsregister
Ingenting blir borte.
Én rad per publisert overflate, med utgivelsen som leverte den. Den siste kolonnen er den du bør følge med på: en fjerning ville dukket opp der med en dato lenge før det skjedde.
| Grensesnitt | Levert | Status | Fjerningsdato |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | gjeldende | ingen planlagt |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | gjeldende | ingen planlagt |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | gjeldende | ingen planlagt |
POST /v1/qa/run | June 12, 2026 | gjeldende | ingen planlagt |
Signed webhook events, twelve typed cases | June 30, 2026 | gjeldende | ingen planlagt |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | gjeldende | ingen planlagt |
En rad slettes aldri fra denne tabellen. Hvis et grensesnitt trekkes tilbake, beholdes raden og det tillegges en dato, siden muligheten til å planlegge for fjerning er hele poenget med å publisere den.
kompatibilitetsløftet
Tre regler du kan bygge videre på.
additiv
Nye endepunkter og nye responsfelt leveres innenfor /v1. Et felt du allerede parser, endrer ikke struktur og forsvinner ikke.
nytt prefiks
En brytende ending vil leveres under et nytt versjonsprefiks i stedet for innenfor dette. Det prefikset er reservert og ubrukt, og hver utgivelse over landet på v1.
ærlige headere
Når en pull ikke kan round-tripe noe, sier den det i en header. X-Skipped-Keys og X-Missing-Source-Keys ble lagt til i stedet for å endre body-en under deg.
Ofte stilte spørsmål
Det utviklere spør om API-versjonering og utfasing.
Er Transglot-API-en versjonskontrollert?
Ja, via URL-prefiks. Alt som er publisert så far ligger under /v1, som er det eneste prefikset i bruk. Det finnes ingen versjonsheader, ingen datofesting og ingenting å konfigurere.
Vil en oppdatering noensinne ødelegge integrasjonen min?
Ikke innenfor /v1. Nye endepunkter og nye responsfelter legges til, men et felt du allerede parser endrer ikke struktur og forsvinner ikke. Hvis en endring ikke kan gjøres additivt, plasseres den under et nytt prefiks, og det gamle fortsetter å fungere.
Har noe blitt utfaset eller fjernet?
Ingenting, og registeret ovenfor bekrefter dette rad for rad. Hver publisert overflate er oppført med utgivelsen som leverte den, og en fjerningskolonne som for øyeblikket viser "ingen planlagt" hele veien ned.
Hvor mye varsel vil man få ved en fjerning?
En fjerning ville dukket opp i dette registeret med en dato lenge før den inntraff, og raden ville blitt stående i tabellen etterpå i stedet for å forsvinne. En dato du kan planlegge etter er hele poenget med å publisere en slik oversikt.
Hvordan vet jeg når noe nytt lanseres?
Hver utgivelse er datostemplet på denne siden. Produktendringsloggen dekker alt annet som lanseres, og konsollen viser en markør når det er noe du ikke har lest.
Hvorfor finnes det en egen endringslogg for API-en?
Fordi API-en har et kompatibilitetsløfte som en produktutgivelse ikke har. En utvikler som sjekker om en integrasjon fortsatt fungerer, bør ikke måtte scrolle forbi funksjonsarbeid for å finne ut av det.
Hvordan legger jeg til API-en i planen min?
Et bearer-token starter på Starter-planen til $19 per måned. Gratisversjonen dekker konsollen, men kan ikke opprette et token, og CLI-en, GitHub Action, webhooks og MCP ligger alle bak det samme tokenet.
Hvor finner jeg referansen for selve endepunktene?
På API-siden: autentisering, endepunkter, hastighetsbegrensning, filformater og webhook-katalog. Denne siden er kun en oversikt over hva som har endret seg og når.
fungerer med det du allerede bruker
41 koblinger, allerede bygget.
kontrakten er produktet
Bygg på et API som ikke endrer seg.
API-et er tilgjengelig på Starter-abonnement og høyere. Gratis er $0 med 100 000 ord til å starte med (25 000 ved registrering, 75 000 etter telefonverifisering), deretter 10 000 per måned, og ingen API- eller webhook-tilgang.