added
Deploy-nøglemodellen, hvor bearer-tokenet ER projektet. Det er det, både CLI'en og GitHub Action kører på.
api v1 · aktuelt
API-ændringsloggen.
Intet er fjernet.
/v1 får kun nye funktioner. Nye endpoints og nye responsfelter tilføjes under samme præfiks, og et felt, du allerede parser, ændrer aldrig form eller forsvinder. En brydende ændring vil blive leveret under et nyt versionspræfiks, som er reserveret og stadig tomt.
v1/api/v1
det eneste præfiks i brug
det eneste præfiks i brug
5 udgivelser
11 ændringer, ingen af dem brydende
loggens struktur
Ét versionspræfiks, ingen fjernelser.
Tre af disse fire er egenskaber ved selve loggen. Den fjerde er størrelsen på webhook-kataloget, som API'en betjener.
5
udgivelser på /v1, alle er additive
1
versionspræfiks i brug. Det næste er reserveret og tomt
0
brydende ændringer siden API'ens lancering
12
signerede webhook-begivenheder. Kilde: App\Enums\WebhookEvent
dateret efter udgivelse, ikke efter semver
brug piletasterne til at navigere
2026-07-08
CDN-levering, forbrug og legeplads
July 8, 2026 · 4 ændringer
05 / 05
added
/v1/incontext/translations, /screenshots og /suggest driver den visuelle editor, med CORS begrænset til dette præfiks og intet andet.
POST /v1/incontext/session udveksler en publicerbar nøgle og en Origin for et scoped sessionstoken.
improved
En tosproget eksport rapporterer nu, hvad den ikke kunne round-trippe, i stedet for stille at erstatte med kildetekst. Eksisterende felter er uændrede, hvilket netop er pointen med at placere det i en header.
GET /v1/pull fik response-headere X-Skipped-Keys og X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export og /extract, så en termbase kan flyttes ind og ud uden at åbne konsollen.
Fuld CRUD af termbase via API: GET, POST, PUT og DELETE på /v1/glossary.
added
Fund lander på de oversættelsesrækker, du allerede henter, så der skal ikke polls noget nyt.
POST /v1/qa/run udløser et agentbaseret kvalitetstjek og returnerer kørselshåndtaget.
added
Abonner pr. endpoint. Listen findes i App\Enums\WebhookEvent, som i dag indeholder tolv cases; tæl enummen frem for denne linje.
Signerede webhooks udsender nøgle-, oversættelses-, sprog-, glossar- og QA-hændelser sammen med det oprindelige batch-par.
improved
Leveringen indeholder et antal og op til tyve prøver i stedet for ét kald per ændret række. Leveringslogfiler registrerer hvert forsøg med tidspunktet for næste genforsøg.
Højfrekvente hændelser som translation.updated samles til én levering per vindue, så en bulkredigering aldrig oversvømmer et endpoint.
added
Den returnerer en ETag og en kortvarig cache og respekterer If-None-Match med en 304. Den immutable søster under /v{n} er content-addresseret og cachelagret i et år.
En offentlig, edge-cachebar GET /v1/cdn/{project}/{locale} serverer dine publicerede strenge.
added
Udløs det i CI med POST /v1/cdn/publish, og autoriser læsninger med en dedikeret read-only-nøgle i headern X-Transglot-Cdn-Key. Sikker at placere bag dit eget CDN.
Publicering promoverer de aktuelle oversættelser til en ny immutable version, manuelt eller ved hver push.
added
Der gemmes ingen request bodies. Det er kun et tal og intet andet.
Hvert autentificeret /v1-kald tælles per token per dag og vises på deploy-hubben.
improved
Projekt, pull, batches og glossareksport. Ingen request- eller response-form ændret for at få det til at virke.
Deploy-hubben fik en API-legeland, der kører read-only endpoints live mod dit projekt.
deprecations-register
Intet er udgår.
Én række pr. offentliggjort overflade med den udgivelse, der leverede den. Den sidste kolonne er den, du skal holde øje med: En fjernelse vil fremgå her med en dato længe før, den finder sted.
| Overflade | Leveret | Status | Fjernelsesdato |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | aktuel | ingen planlagt |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | aktuel | ingen planlagt |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | aktuel | ingen planlagt |
POST /v1/qa/run | June 12, 2026 | aktuel | ingen planlagt |
Signed webhook events, twelve typed cases | June 30, 2026 | aktuel | ingen planlagt |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | aktuel | ingen planlagt |
En række slettes aldrig fra denne tabel. Hvis en overflade udgår, beholdes rækken og får en dato, da muligheden for at planlægge efter en fjernelse er hele formålet med at offentliggøre den.
kompatibilitetsløftet
Tre regler du kan bygge videre på.
additiv
Nye endpoints og nye svarfelter leveres inden for /v1. Et felt, du allerede parser, ændrer ikke struktur og forsvinder ikke.
nyt præfiks
En brydende ændring vil blive leveret under et nyt versionspræfiks frem for inden for dette. Det præfiks er reserveret og ubrugt, og hver udgivelse ovenfor er landet på v1.
ærlige headere
Når en pull ikke kan round-trippe noget, angives det i en header. X-Skipped-Keys og X-Missing-Source-Keys blev tilføjet frem for at ændre body'en undervejs.
FAQ
Det, udviklere spørger om API-versionering og udfasning.
Er Transglot-API'et versioneret?
Ja, via URL-prefix. Alt, der er udgivet indtil nu, findes under /v1, hvilket er det eneste prefix i brug. Der er ingen versionsheader, ingen datofastlåsning og intet at konfigurere.
Vil en opdatering nogensinde ødelægge min integration?
Ikke inden for /v1. Nye endpoints og nye responsfelter tilføjes, men et felt, du allerede parser, ændrer ikke form og forsvinder ikke. Hvis en ændring nogensinde ikke kan laves additivt, sker det under et nyt prefix, og det gamle fortsætter med at virke.
Er noget blevet udfaset eller fjernet?
Intet, og registret ovenfor viser det række for række. Alle publicerede overflader er listet med den release, der leverede dem, og en kolonne for fjernelse, der aktuelt læser "ingen planlagt" hele vejen ned.
Hvor meget varsel ville en fjernelse give?
En fjernelse ville fremgå af registret med en dato lang tid før, den fandt sted, og rækken ville blive i tabellen bagefter frem for at forsvinde. En dato, du kan planlægge efter, er hele pointen med at publicere en.
Hvordan ved jeg, når noget nyt lanceres?
Hver release er dateret på denne side. Produktets changelog dækker alt andet, der lanceres, og konsollen viser en markør, når der er noget, du ikke har læst.
Hvorfor er der en separat changelog til API'et?
Fordi API'et har et kompatibilitetsløfte, som en produktrelease ikke har. En udvikler, der tjekker, om en integration stadig virker, bør ikke skulle scrolle forbi funktionsarbejde for at finde ud af det.
Hvordan tilføjer jeg API'et til min plan?
Et bearer-token starter på Starter-planen til $19 om måneden. Gratis dækker konsollen, men kan ikke udstede et token, og CLI'en, GitHub Action, webhooks og MCP kræver alle det samme token.
Hvor finder jeg referencen for selve endpoints?
På API-siden: autentificering, endpoints, rategrænser, filformater og webhook-kataloget. Denne side er kun en oversigt over, hvad der er ændret, og hvornår.
fungerer med det, du allerede kører
41 connectors, allerede bygget.
kontrakten er produktet
Byg på en API som ikke ændres.
API'en er tilgængelig på Starter og derover. Gratis er $0 med 100.000 ord til at starte (25.000 ved tilmelding, 75.000 efter telefonbekræftelse), 10.000 om måneden derefter, og ingen API eller webhooks.