added
Deploy-nyckelmodellen, där bärartokenn är projektet. Det är vad både CLI:t och GitHub Action kör på.
api v1 · aktuell
API-ändringsloggen.
Inget har tagits bort.
/v1 får endast nya funktioner. Nya slutpunkter och nya svarsfält läggs till under samma prefix, och ett fält du redan parsar ändrar aldrig form eller försvinner. En brytande ändring skulle levereras under ett nytt versionsprefix, som är reserverat och fortfarande tomt.
v1/api/v1
det enda prefixet i bruk
det enda prefixet i bruk
5 releaser
11 ändringar, ingen av dem brytande
loggens struktur
Ett versionsprefix, inga borttagningar.
Tre av dessa fyra är egenskaper hos själva loggen. Den fjärde är storleken på webbhookkatalogen som API:t betjänar.
5
releaser på /v1, alla additiva
1
versionsprefix i bruk. Det nästa är reserverat och tomt
0
brytande ändringar sedan API:t lanserades
12
signerade webhookhändelser. Källa: App\Enums\WebhookEvent
daterade efter release, inte efter semver
använd piltangenterna för att navigera
2026-07-08
CDN-leverans, användning och playground
July 8, 2026 · 4 ändringar
05 / 05
added
/v1/incontext/translations, /screenshots och /suggest driver den visuella editorn, med CORS begränsat till det prefixet och inget annat.
POST /v1/incontext/session byter ut en publicerbar nyckel och ett Origin mot en sessionstoken med begränsad åtkomst.
improved
En tvåspråkig export rapporterar nu vad som inte kunde rundas tillbaka istället för att tyst ersätta källtexten. Befintliga fält är oförändrade, vilket är hela poängen med att placera det i en header.
GET /v1/pull fick svarsheadrarna X-Skipped-Keys och X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export och /extract, så att en termbas kan flyttas in och ut utan att öppna konsolen.
Fullständig CRUD för termbasen via API:et: GET, POST, PUT och DELETE på /v1/glossary.
added
Resultaten hamnar på de översättningsrader du redan hämtar, så inget nytt behöver pollas.
POST /v1/qa/run triggar en agentbaserad kvalitetskontroll och returnerar körningshandtaget.
added
Prenumerera per slutpunkt. Listan finns i App\Enums\WebhookEvent, som idag har tolv fall; räkna enum:en istället för denna rad.
Signerade webhooks emitterar händelser för nycklar, översättningar, språk, ordlistor och QA tillsammans med det ursprungliga batch-paret.
improved
Leveransen innehåller en räknare och upp till tjugo exempel istället för ett anrop per ändrad rad. Leveransloggar registrerar varje försök med tidpunkten för nästa omförsök.
Högfrekventa händelser som translation.updated slås samman till en leverans per tidsfönster, så att en massredigering aldrig överbelastar en slutpunkt.
added
Den returnerar en ETag och en kortlivad cache och respekterar If-None-Match med en 304. Den immutabla syskonversionen under /v{n} är innehållsadresserad och cachad i ett år.
En offentlig, edge-cachebar GET /v1/cdn/{project}/{locale} serverar dina publicerade strängar.
added
Trigga det i CI med POST /v1/cdn/publish och auktorisera läsningar med en dedikerad skrivskyddad nyckel i headern X-Transglot-Cdn-Key. Säker att placera bakom din egen CDN.
Publicering befordrar de aktuella översättningarna till en ny immutabel version, manuellt eller vid varje push.
added
Inga request-body:n lagras. Det är en räkning och inget annat.
Varje autentiserat /v1-anrop räknas per token per dag och visas på deploy-hubben.
improved
Projekt, pull, batcher och glosariexport. Ingen förfrågan eller svarsstruktur ändrades för att få det att fungera.
Deploy-hubben fick en API-playground som kör skrivskyddade slutpunkter live mot ditt projekt.
deprecationsregister
Ingenting är på väg bort.
En rad per publicerad yta, med den release som levererade den. Den sista kolumnen är den att hålla ögonen på: en borttagning skulle dyka upp där med ett datum långt innan den inträffade.
| Yta | Levererad | Status | Borttagningsdatum |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | nuvarande | inga inplanerade |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | nuvarande | inga inplanerade |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | nuvarande | inga inplanerade |
POST /v1/qa/run | June 12, 2026 | nuvarande | inga inplanerade |
Signed webhook events, twelve typed cases | June 30, 2026 | nuvarande | inga inplanerade |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | nuvarande | inga inplanerade |
En rad raderas aldrig från denna tabell. Om en yta tas ur bruk behåller den sin rad och får ett datum, eftersom en borttagning du kan planera för är hela poängen med att publicera en.
kompatibilitetslöftet
Tre regler du kan bygga vidare på.
additiv
Nya slutpunkter och nya svarsfält levereras inom /v1. Ett fält du redan analyserar ändrar inte form och försvinner inte.
nytt prefix
En brytande förändring skulle levereras under ett nytt versionsprefix snarare än inom detta. Det prefixet är reserverat och oanvänt, och varje release ovanför hamnade på v1.
ärliga rubriker
När en pull-request inte kan round-tripa något anger den det i en rubrik. X-Skipped-Keys och X-Missing-Source-Keys lades till istället för att ändra innehållet under dig.
FAQ
Vad utvecklare frågar om API-versionering och utfasning.
Är Transglot-API:et versionerat?
Ja, via URL-prefix. Allt som publicerats hittills finns under /v1, vilket är det enda prefixet som används. Det finns inget versionshuvud, ingen datumspikning och inget att konfigurera.
Kommer en uppdatering någonsin att bryta min integration?
Inte inom /v1. Nya slutpunkter och nya svarsfält läggs till, men ett fält du redan analyserar ändrar inte form och försvinner inte. Om en förändring någonsin inte kan göras additivt går den under ett nytt prefix, och det gamla fortsätter att fungera.
Har något fasats ut eller tagits bort?
Ingenting, och registret ovan säger så rad för rad. Varje publicerad yta listas med den release som levererade den och en kolumn för borttagning som för närvarande lyder "ingen planerad" hela vägen ner.
Hur mycket förvarning skulle en borttagning få?
En borttagning skulle visas i det registret med ett datum långt innan det hände, och raden skulle stanna kvar i tabellen efteråt istället för att försvinna. Ett datum du kan planera efter är hela poängen med att publicera ett.
Hur vet jag när något nytt lanseras?
Varje release är daterad på den här sidan. Produktens ändringslogg täcker allt annat som släpps, och konsolen visar en markör när det finns något du inte har läst.
Varför finns det en separat ändringslogg för API:t?
Eftersom API:t har ett kompatibilitetslöfte som en produktrelease inte har. En utvecklare som vill kontrollera om en integration fortfarande fungerar ska inte behöva bläddra förbi funktionsutveckling för att ta reda på det.
Hur lägger jag till API:t i min plan?
En bearer-token börjar på Starter-planen för 19 USD per månad. Gratisplanen täcker konsolen men kan inte skapa en token, och CLI:t, GitHub Action, webhooks och MCP ligger alla bakom samma token.
Var finns referensen för själva slutpunkterna?
På API-sidan: autentisering, slutpunkter, hastighetsbegränsning, filformat och webhook-katalog. Den här sidan är endast registret över vad som ändrades och när.
fungerar med det du redan kör
41 kopplingar, redan byggda.
kontraktet är produkten
Bygg på ett API som inte rör sig.
API:t finns på Starter och högre. Gratis är 0 USD med 100 000 ord att börja med (25 000 vid registrering, 75 000 efter telefonverifiering), 10 000 per månad därefter, och inget API eller webhooks.