added
La modelo de deploja ŝlosilo, kie la portanta ĵetono ESTAS la projekto. Ĝi estas tio, sur kio funkcias kaj la CLI kaj la GitHub Action.
api v1 · aktuala
La API-ŝanĝprotokolo.
Nenio forigita.
/v1 nur akiras novajn funkciojn. Novaj finpunktoj kaj novaj kampoj en respondoj aldoniĝas sub la sama prefikso, kaj kampo, kiun vi jam analizas, neniam ŝanĝas sian strukturon aŭ malaperas. Rompa ŝanĝo estus publikigita sub nova versia prefikso, kiu estas rezervita kaj ankoraŭ malplena.
v1/api/v1
la sola uzata prefikso
la sola uzata prefikso
5 eldonoj
11 ŝanĝoj, neniuj rompitaj
la formo de la protokolo
Unu versia prefikso, neniuj forigoj.
Tri el ĉi tiuj kvar estas ecoj de ĉi tiu protokolo mem. La kvara estas la grandeco de la katalogo de retmesaĝoj, kiujn la API servas.
5
eldonoj sur /v1, ĉiuj aldonaĵoj
1
versia prefikso uzata. La sekva estas rezervita kaj malplena
0
rompantaj ŝanĝoj ekde la lanĉo de la API
12
subskribitaj eventoj de retmesaĝoj. Fonto: App\Enums\WebhookEvent
datitaj laŭ eldono, ne laŭ semver
uzu la sagklavojn por navigi
2026-07-08
CDN-liverado, uzado kaj la ludareno
July 8, 2026 · 4 ŝanĝoj
05 / 05
added
/v1/incontext/translations, /screenshots kaj /suggest movigas la vidan redaktilon, kun CORS limigita al tiu prefikso kaj nenio alia.
POST /v1/incontext/session interŝanĝas publikigeblan ŝlosilon kaj Originon por sesia ĵetono kun limigita amplekso.
improved
Dulingva eksporto nun raportas tion, kion ĝi ne povis ronde transdoni, anstataŭ silente anstataŭigi fontan tekston. Ekzistantaj kampoj restas senŝanĝaj, kio estas la tuta celo meti ĝin en kapo.
GET /v1/pull akiris la respondkapojn X-Skipped-Keys kaj X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export kaj /extract, do terminobazo povas esti movita enen kaj elsen malfermi la konzolon.
Plena CRUD por terminobazo per la API: GET, POST, PUT kaj DELETE sur /v1/glossary.
added
Trovaĵoj aperas en la tradukaj vicoj, kiujn vi jam petas, do nenio nova bezonas esti kontrolata.
POST /v1/qa/run ekigas agentan kvalitan kontrolon kaj redonas la identigilon de la plenumo.
added
Abonu per finpunkto. La listo mem troviĝas en App\Enums\WebhookEvent, kiu nuntempe enhavas dek du kazojn; kalkulu la enumon anstataŭ ĉi tiu linio.
Subskribitaj retligiloj eligas ŝlosilajn, tradukajn, lingvajn, glosarajn kaj QA-eventojn kune kun la origina aro da paroj.
improved
La livero portas nombron kaj ĝis dudek specimenojn anstataŭ unu voko por ŝanĝita vico. Liveraj protokoloj registras ĉiun provon kun la tempo de la sekva reprovo.
Altfrekvencaj eventoj kiel translation.updated estas kunigitaj en unu liveron dum fenestro, do amasa redaktado neniam inundas finpunkton.
added
Ĝi redonas ETag kaj mallongdaŭran kaŝmemoron kaj respektas If-None-Match per 304. La nemodifebla frato sub /v{n} estas adresita laŭ enhavo kaj kaŝmemorigita por unu jaro.
Publika, rand-kaŝebla GET /v1/cdn/{project}/{locale} servas viajn publikigitajn ĉenojn.
added
Ekigu ĝin en CI per POST /v1/cdn/publish, kaj aŭtentigu legadon per dediĉita nurlega ŝlosilo en la kapo X-Transglot-Cdn-Key. Sekure metite malantaŭ CDN de via propra elekto.
Publikigo antaŭenigas la nunajn tradukojn al nova nemodifebla versio, mane aŭ ĉe ĉiu puŝo.
added
Neniuj petkorpoj estas konservataj. Estas nur kalkulo kaj nenio alia.
Ĉiu aŭtentigita /v1 voko estas kalkulata po ĵetono tage kaj montrata sur la deploja centro.
improved
Projekto, tiro, aroj kaj glosara eksporto. Nenia peto aŭ responda formo ŝanĝiĝis por funkciigi ĝin.
La deploja centro akiris API-ludarenon, kiu rulas nurlegajn finpunktojn vive kontraŭ via projekto.
malakcepta registro
Nenio estas foriranta.
Unu vico por ĉiu publikigita surfaco, kun la eldono, kiu liveris ĝin. La lasta kolono estas tiu, kiun oni atentu: forigo aperus tie kun dato longe antaŭ ol ĝi okazus.
| Surfaco | Liverita | Stato | Dato de forigo |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | nuna | nenio planita |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | nuna | nenio planita |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | nuna | nenio planita |
POST /v1/qa/run | June 12, 2026 | nuna | nenio planita |
Signed webhook events, twelve typed cases | June 30, 2026 | nuna | nenio planita |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | nuna | nenio planita |
Linio neniam estas forigita el ĉi tiu tabelo. Se surfaco estas retirita, ĝi konservas sian linion kaj akiras daton, ĉar planeblo de la forigo estas la ĉefa celo de ties publikigo.
la promeso pri kongrueco
Tri reguloj sur kiu vi povas konstrui.
aldona
Novaj finpunktoj kaj novaj kampoj en respondoj aperas ene de /v1. Kampo, kiun vi jam analizas, ne ŝanĝas sian strukturon kaj ne malaperas.
nova prefikso
Grava ŝanĝo aperus sub nova versia prefikso anstataŭ ene de ĉi tiu. Tiu prefikso estas rezervita kaj neuzata, kaj ĉiu eldono super ĝi estis v1.
honestaj kapoj
Kiam peto ne povas plene retroiri ion, ĝi indikas tion en kapo. X-Skipped-Keys kaj X-Missing-Source-Keys estis aldonitaj anstataŭ ŝanĝi la korpon sub vi.
Oftaj demandoj
Kion programistoj demandas pri API-versiado kaj malaktualigo.
Ĉu la Transglot-API havas versiojn?
Jes, per URL-prefikso. Ĉio ĝis nun publikigita troviĝas sub /v1, kiu estas la sola uzata prefikso. Ne ekzistas versia kapo, ne ekzistas dato-fiksado kaj nenio agordenda.
Ĉu ĝisdatigo iam rompos mian integriĝon?
Ne ene de /v1. Novaj finpunktoj kaj novaj kampoj en respondoj aldoniĝas, sed kampo, kiun vi jam analizas, ne ŝanĝas sian strukturon kaj ne malaperas. Se ŝanĝo iam ne povas esti farita aldona, ĝi iras sub nova prefikso, kaj la malnova plu funkcias.
Ĉu io estis malaktualigita aŭ forigita?
Nenio, kaj la supra registro tion diras linie post linio. Ĉiu publikigita surfaco listiĝas kun la eldono, kiu liveris ĝin, kaj kolono pri forigo, kiu nuntempe legas "nenio planita" tute malsupre.
Kiom da antaŭaverto ricevus forigo?
Forigo aperus en tiu registro kun dato longe antaŭ ol ĝi okazus, kaj la linio restus en la tabelo poste anstataŭ malaperi. Dato, kontraŭ kiu vi povas plani, estas la tuta celo de publikigi unu.
Kiel mi scias, kiam io nova lanĉiĝas?
Ĉiu eldono datiĝas sur ĉi tiu paĝo. La produkta ŝanĝoprotokolo kovras ĉion alian, kio lanĉiĝas, kaj la konzolo montras markilon, kiam estas io, kion vi ne legis.
Kial ekzistas aparta ŝanĝoprotokolo por la API?
Ĉar la API portas promeson pri kongrueco, kiun produkta eldono ne portas. Programisto, kontrolanta ĉu integriĝo ankoraŭ funkcias, ne devus rulumi preter funkcia laboro por eltrovi tion.
How do I add the API to my plan?
A bearer token starts on the Starter plan at $19 a month. Free covers the console but cannot mint a token, and the CLI, the GitHub Action, webhooks and MCP all sit behind that same token.
Kie troviĝas la referenco por la finpunktoj mem?
Sur la API-paĝo: aŭtentigo, la finpunktoj, la limigo de petoj, la dosierformatoj kaj la katalogo de retmesaĝoj. Ĉi tiu paĝo estas nur registro pri tio, kio ŝanĝiĝis kaj kiam.
funkcias kun tio, kion vi jam uzas
41 konektiloj, jam pretaj.
la kontrakto estas la produkto
Konstruu sur API kiu ne moviĝas.
La API disponeblas en la plano Starter kaj super. Senpaga estas $0 kun 100 000 vortoj por komenci (25 000 je registriĝo, 75 000 post telefona kontrolo), poste 10 000 monate, kaj neniu API aŭ retmesaĝoj.