added
Het deploy-key-model, waarbij het bearer-token HET project is. Dit is wat zowel de CLI als de GitHub Action gebruiken.
api v1 · huidig
De API-changelog.
Niets verwijderd.
/v1 krijgt alleen maar functies erbij. Nieuwe eindpunten en nieuwe responsvelden worden toegevoegd binnen hetzelfde voorvoegsel, en een veld dat je al parseert verandert nooit van vorm of verdwijnt. Een breaking change zou worden uitgebracht onder een nieuw versievoorvoegsel, dat gereserveerd is en nog leeg.
v1/api/v1
het enige voorvoegsel in gebruik
het enige voorvoegsel in gebruik
5 releases
11 wijzigingen, geen enkele breaking
de vorm van het logboek
Eén versievoorvoegsel, geen verwijderingen.
Drie van deze vier zijn eigenschappen van dit logboek zelf. De vierde is de omvang van de webhookcatalogus die de API levert.
5
releases op /v1, allemaal additief
1
versievoorvoegsel in gebruik. Het volgende is gereserveerd en leeg
0
breaking changes sinds de lancering van de API
12
ondertekende webhook-gebeurtenissen. Bron: App\Enums\WebhookEvent
gedateerd per release, niet per semver
gebruik de pijltjestoetsen om te navigeren
2026-07-08
CDN-levering, gebruik en de playground
July 8, 2026 · 4 wijzigingen
05 / 05
added
/v1/incontext/translations, /screenshots en /suggest sturen de visuele editor aan, met CORS beperkt tot dat voorvoegsel en niets anders.
POST /v1/incontext/session wisselt een publiceerbare sleutel en een Origin in voor een scoped sessietoken.
improved
Een tweetalige export rapporteert nu wat niet round-trip kon worden verwerkt, in plaats van brontekst stilzwijgend te vervangen. Bestaande velden blijven ongewijzigd, wat precies het doel is van plaatsing in een header.
GET /v1/pull heeft de responseheaders X-Skipped-Keys en X-Missing-Source-Keys gekregen.
added
Plus /v1/glossary/import, /export en /extract, zodat een termbasis kan worden geïmporteerd en geëxporteerd zonder de console te openen.
Volledige CRUD-bewerkingen voor de termbasis via de API: GET, POST, PUT en DELETE op /v1/glossary.
added
Bevindingen verschijnen op de vertaalrijen die je al ophaalt, dus er hoeft niets nieuws te worden gepolled.
POST /v1/qa/run start een agentische kwaliteitscontrole en retourneert de run-handle.
added
Abonneer per endpoint. De lijst zelf staat in App\Enums\WebhookEvent, die vandaag twaalf cases bevat; tel de enum in plaats van deze regel.
Ondertekende webhooks verzenden sleutel-, vertaal-, taal-, glossarium- en QA-events naast het originele batchpaar.
improved
De levering bevat een telling en maximaal twintig voorbeelden, in plaats van één oproep per gewijzigde rij. Leveringslogs registreren elke poging met het tijdstip van de volgende retry.
Hoogfrequente events zoals translation.updated worden samengevoegd tot één levering per venster, zodat een bulkbewerking een endpoint nooit overspoelt.
added
Het retourneert een ETag en een kortstondige cache, en respecteert If-None-Match met een 304. Het immutable sibling onder /v{n} is content-addressed en een jaar gecached.
Een openbare, edge-cacheable GET /v1/cdn/{project}/{locale} serveert je gepubliceerde strings.
added
Trigger het in CI met POST /v1/cdn/publish, en autoriseer reads met een dedicated read-only key in de X-Transglot-Cdn-Key header. Veilig om achter je eigen CDN te plaatsen.
Publiceren promoot de huidige vertalingen naar een nieuwe immutable versie, handmatig of bij elke push.
added
Er worden geen request bodies opgeslagen. Het is alleen een telling.
Elke geauthenticeerde /v1-oproep wordt per token per dag geteld en weergegeven op de deploy hub.
improved
Project, pull, batches en glossariumexport. Er is geen request- of responseshape gewijzigd om dit mogelijk te maken.
De deploy hub heeft een API-playground gekregen die read-only endpoints live tegen je project uitvoert.
deprecationsregister
Niets gaat verdwijnen.
Één rij per gepubliceerd oppervlak, met de release waarin het werd uitgebracht. De laatste kolom is degene om in de gaten te houden: een verwijdering zou daar lang van tevoren met een datum verschijnen.
| Oppervlak | Verzonden | Status | Verwijderdatum |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | huidig | geen gepland |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | huidig | geen gepland |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | huidig | geen gepland |
POST /v1/qa/run | June 12, 2026 | huidig | geen gepland |
Signed webhook events, twelve typed cases | June 30, 2026 | huidig | geen gepland |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | huidig | geen gepland |
Een rij wordt nooit uit deze tabel verwijderd. Als een oppervlak wordt gepensioneerd, behoudt het zijn rij en krijgt het een datum, omdat een verwijdering waartegen je kunt plannen het hele doel is van publicatie.
de compatibiliteitsgarantie
Drie regels waarop je kunt bouwen.
additief
Nieuwe eindpunten en nieuwe responsvelden worden geleverd binnen /v1. Een veld dat je al parseert, verandert niet van structuur en verdwijnt niet.
nieuw voorvoegsel
Een breaking change wordt uitgebracht onder een nieuw versievoorvoegsel in plaats van binnen deze versie. Dat voorvoegsel is gereserveerd en ongebruikt, en elke release hierboven is uitgekomen op v1.
eerlijke headers
Wanneer een pull-request iets niet kan round-trippen, geeft dit aan in een header. X-Skipped-Keys en X-Missing-Source-Keys zijn toegevoegd in plaats van de body onder jou te wijzigen.
FAQ’s
Wat ontwikkelaars vragen over API-versionering en depreciatie.
Is de Transglot API geversioneerd?
Ja, via URL-voorvoegsels. Alles wat tot nu toe is gepubliceerd, valt onder /v1, het enige voorvoegsel dat in gebruik is. Er is geen versieheader, geen datum-pinning en niets om te configureren.
Zal een update mijn integratie ooit breken?
Niet binnen /v1. Nieuwe eindpunten en nieuwe responsvelden worden toegevoegd, maar een veld dat je al parseert, verandert niet van structuur en verdwijnt niet. Als een wijziging ooit niet additief kan worden gemaakt, gebeurt dit onder een nieuw voorvoegsel, en het oude blijft werken.
Is er iets verouderd of verwijderd?
Niets, en het register hierboven bevestigt dit regel voor regel. Elk gepubliceerd oppervlak wordt vermeld met de release waarin het werd uitgebracht en een kolom voor verwijdering die momenteel overal 'geen gepland' aangeeft.
Hoeveel kennisgeving zou een verwijdering krijgen?
Een verwijdering zou lang van tevoren in dat register verschijnen met een datum, en de rij zou daarna in de tabel blijven staan in plaats van te verdwijnen. Een datum waarop je kunt plannen, is het hele doel van publiceren.
Hoe weet ik wanneer er iets nieuws wordt uitgebracht?
Elke release is gedateerd op deze pagina. De productchangelog behandelt alles wat verder wordt uitgebracht, en de console toont een marker wanneer er iets is dat je nog niet hebt gelezen.
Waarom is er een aparte changelog voor de API?
Omdat de API een compatibiliteitsgarantie draagt die een productrelease niet heeft. Een ontwikkelaar die controleert of een integratie nog werkt, hoeft niet door feature-werk te scrollen om dit te ontdekken.
Hoe voeg ik de API toe aan mijn plan?
Een bearer-token begint bij het Starter-plan voor $19 per maand. Free dekt de console maar kan geen token genereren, en de CLI, de GitHub Action, webhooks en MCP zitten allemaal achter datzelfde token.
Waar is de referentie voor de eindpunten zelf?
Op de API-pagina: authenticatie, de eindpunten, de rate limit, de bestandsformaten en de webhookcatalogus. Deze pagina is alleen het overzicht van wat er is veranderd en wanneer.
werkt met wat je al draait
41 connectors, al gebouwd.
het contract is het product
Bouw op een API die niet verandert.
De API is beschikbaar vanaf Starter en hoger. Free is $0 met 100.000 woorden om mee te beginnen (25.000 bij aanmelding, 75.000 na een telefooncontrole), daarna 10.000 per maand, en geen API of webhooks.