added
Ang deploy-key model, kung saan ang bearer token AY ang project mismo. Ito ang pinapatakbo ng CLI at ng GitHub Action.
api v1 · kasalukuyan
Ang API changelog.
Walang inalis.
Ang /v1 ay laging nagdaragdag lamang ng mga bagay. Ang mga bagong endpoint at mga bagong field ng response ay idinadagdag sa loob ng parehong prefix, at ang isang field na iyong pinaparse ay hindi kailanman nagbabago ng anyo o nawawala. Ang isang breaking change ay ilalabas sa ilalim ng bagong version prefix, na nakalaan at walang laman pa.
v1/api/v1
ang tanging prefix na ginagamit
ang tanging prefix na ginagamit
5 release
11 pagbabago, wala sa kanila ang breaking
ang anyo ng log
Isang version prefix, walang tinatanggal.
Tatlo sa apat na ito ay mga katangian ng log mismo. Ang ika-apat ay ang laki ng webhook catalog na inihahain ng API.
5
mga release sa /v1, bawat isa ay additive
1
version prefix na ginagamit. Ang susunod ay nakalaan at walang laman
0
breaking changes mula nang ilunsad ang API
12
signed webhook events. Pinagmulan: App\Enums\WebhookEvent
petsahan ayon sa release, hindi ayon sa semver
gamitin ang arrow keys para mag-navigate
2026-07-08
CDN delivery, usage, at ang playground
July 8, 2026 · 4 pagbabago
05 / 05
added
Ang /v1/incontext/translations, /screenshots at /suggest ang nagpapatakbo sa visual editor, na may CORS na naka-scope sa prefix na iyon at wala pang iba.
Ang POST /v1/incontext/session ay nagpapalit ng publishable key at Origin para sa scoped session token.
improved
Ang bilingual export ay ngayon ay nag-uulat kung ano ang hindi niya ma-round-trip imbes na tahimik na palitan ng source text. Ang mga umiiral na field ay hindi nabago, na siyang buong punto ng paglalagay nito sa header.
Ang GET /v1/pull ay nakakuha ng X-Skipped-Keys at X-Missing-Source-Keys response headers.
added
Kasama ang /v1/glossary/import, /export at /extract, kaya ang term base ay maaaring ilipat papasok at palabas nang hindi binubuksan ang console.
Buong term-base CRUD sa API: GET, POST, PUT at DELETE sa /v1/glossary.
added
Ang mga natuklasan ay lumalabas sa mga translation rows na hinihila mo na, kaya walang kailangang i-poll.
Ang POST /v1/qa/run ay nagtutriga ng agentic quality pass at ibinabalik ang run handle.
added
Mag-subscribe bawat endpoint. Ang listahan mismo ay nasa App\Enums\WebhookEvent, na may labindalawang case ngayon; bilangin ang enum imbes na linyang ito.
Ang mga signed webhook ay naglalabas ng mga event para sa key, translation, language, glossary, at QA kasama ang orihinal na batch pair.
improved
Ang delivery ay may kasamang count at hanggang dalawampung sample imbes na isa-isa para sa bawat binagong row. Ang mga delivery log ay nagrerekord ng bawat attempt kasama ang oras ng susunod na retry.
Ang mga high-frequency event tulad ng translation.updated ay pinagsasama sa isang delivery kada window, kaya ang bulk edit ay hindi bumabaha sa endpoint.
added
Ibinabalik nito ang ETag at short-lived cache, at sinusunod ang If-None-Match gamit ang 304. Ang immutable sibling sa ilalim ng /v{n} ay content-addressed at naka-cache sa loob ng isang taon.
Ang pampubliko at edge-cacheable na GET /v1/cdn/{project}/{locale} ay nagsisilbi ng iyong mga published string.
added
I-trigger ito sa CI gamit ang POST /v1/cdn/publish, at i-authorize ang mga read gamit ang dedikadong read-only key sa X-Transglot-Cdn-Key header. Ligtas itong ilagay sa likod ng sarili mong CDN.
Ang pag-publish ay nagpo-promote ng kasalukuyang translations sa bagong immutable version, manu-mano o sa bawat push.
added
Walang request body na iniimbak. Ito ay isang count at wala nang iba.
Bawat authenticated /v1 call ay binibilang per token kada araw, at ipinapakita sa deploy hub.
improved
Project, pull, batches, at glossary export. Walang request o response shape na binago para gumana ito.
Ang deploy hub ay nakakuha ng API playground na nagpapatakbo ng read-only endpoints live laban sa iyong project.
deprecation register
Walang mawawala.
Isang row bawat published surface, kasama ang release na nag-shipping nito. Ang huling column ang dapat bantayan: ang pag-alis ay lilitaw doon na may petsa nang matagal bago ito mangyari.
| Surface | Naipadala | Katayuan | Petsa ng pag-alis |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | kasalukuyan | walang naka-iskedyul |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | kasalukuyan | walang naka-iskedyul |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | kasalukuyan | walang naka-iskedyul |
POST /v1/qa/run | June 12, 2026 | kasalukuyan | walang naka-iskedyul |
Signed webhook events, twelve typed cases | June 30, 2026 | kasalukuyan | walang naka-iskedyul |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | kasalukuyan | walang naka-iskedyul |
Hindi kailanman binubura ang isang hilera mula sa talahanayang ito. Kapag iniretiro ang isang surface, pinapanatili nito ang hilera at nagkakaroon ng petsa, dahil ang mahahalagang aspeto ng paglalathala ay ang kakayahang magplano para sa pag-aalis.
ang pangako ng pagiging compatible
Tatlong patakaran maaari mong pagtibayin.
additive
Ang mga bagong endpoint at bagong field ng response ay ipinapadala sa loob ng /v1. Ang field na iyong binabasa ay hindi nagbabago ng anyo at hindi nawawala.
bagong prefix
Ang isang breaking change ay ipapadala sa ilalim ng bagong version prefix imbes na sa loob ng kasalukuyang bersyon. Ang prefix na iyon ay nakareserba at hindi ginagamit, at bawat release sa itaas ay naka-base sa v1.
tapat na mga header
Kapag hindi ma-round-trip ng pull ang isang bagay, ipinapahiwatig nito ito sa pamamagitan ng header. Idinagdag ang X-Skipped-Keys at X-Missing-Source-Keys imbes na baguhin ang body nang direkta.
Mga FAQ
Mga tanong ng mga developer tungkol sa pagbe-bersyon at pag-deprecate ng API.
May bersyon ba ang Transglot API?
Oo, ayon sa prefix ng URL. Lahat ng nailathala hanggang ngayon ay nasa ilalim ng /v1, na tanging prefix na ginagamit. Walang version header, walang date pinning, at walang kailangang i-configure.
Masisira ba ng update ang aking integration?
Hindi sa loob ng /v1. Idinadagdag ang mga bagong endpoint at bagong response field, ngunit hindi nagbabago ang anyo o nawawala ang field na iyong binabasa na. Kung may pagbabagong hindi maipapatupad nang additively, ilalagay ito sa ilalim ng bagong prefix, habang patuloy na gumagana ang lumang isa.
May na-deprecate o na-alis na ba?
Wala, at ipinapakita ito ng register sa itaas row by row. Nakalista ang bawat published surface kasama ang release na naglunsad nito at isang column para sa pag-aalis na kasalukuyang nagsasabing "none scheduled" pababa.
Gaano katagal ang abiso bago ang pag-aalis?
Magpapakita ang pag-aalis sa register na may nakatakdang petsa nang matagal bago ito mangyari, at mananatili ang row sa talahanayan pagkatapos nito imbes na mawala. Ang petsang maaari mong gamitin sa pagpaplano ang pangunahing dahilan kung bakit ito inilalathala.
Paano ko malalaman kung may bagong ilalabas?
Nakapetsa ang bawat release sa pahinang ito. Sakop ng product changelog ang lahat ng ibang nilalabas, at nagpapakita ng marker ang console kapag mayroong hindi mo pa nababasa.
Bakit may hiwalay na changelog para sa API?
Dahil may compatibility promise ang API na wala sa product release. Hindi dapat mag-scroll past feature work ang developer na naghahanap kung gumagana pa ang integration.
Paano ko idadagdag ang API sa aking plan?
Nagsisimula ang bearer token sa Starter plan sa $19 bawat buwan. Sakop ng Free ang console ngunit hindi makakagawa ng token, at nasa likod ng parehong token ang CLI, GitHub Action, webhooks, at MCP.
Nasaan ang reperensya para sa mga endpoint mismo?
Sa pahina ng API: authentication, ang mga endpoint, ang rate limit, ang mga file format, at ang webhook catalog. Ang pahinang ito ay tala lamang ng mga pagbabago at kung kailan ito nangyari.
gumagana sa mga ginagamit mo na
41 connector, handa na.
ang kontrata ang produkto
Mag-build gamit ang API na hindi gumagalaw.
Ang API ay nasa Starter pataas. Libre ay $0 na may 100,000 salita pang-simula (25,000 sa pag-sign up, 75,000 pagkatapos ng phone check), 10,000 bawat buwan pagkatapos, at walang API o webhooks.