added
Моделът с ключ за деплой, при който носещият токен Е проектът. Това е средата, в която работят както CLI, така и GitHub Action.
api v1 · текуща
Дневникът на промените в API.
Нищо не е премахнато.
/v1 само добавя неща. Нови крайни точки и нови полета в отговорите се появяват в рамките на същия префикс, а поле, което вече анализирате, никога не променя структурата си и не изчезва. Критична промяна би била пусната под нов префикс на версията, който е резервиран и все още е празен.
v1/api/v1
единственият използван префикс
единственият използван префикс
5 издания
11 промени, нито една от които критична
структурата на дневника
Един префикс на версия, без премахвания.
Три от тези четири са свойства на самия регистър. Четвъртото е размерът на каталога с уеб куки, който API предоставя.
5
версии за /v1, всяка една от тях добавъчна
1
използван префикс на версията. Следващият е резервиран и празен
0
промени, нарушаващи обратната съвместимост, откакто API е пуснат
12
подписани събития за уеб куки. Източник: App\Enums\WebhookEvent
датирани по версия, а не по semver
използвайте стрелките за навигация
2026-07-08
CDN доставка, употреба и playground
July 8, 2026 · 4 промени
05 / 05
added
/v1/incontext/translations, /screenshots и /suggest задвижват визуалния редактор, като CORS е ограничен до този префикс и нищо друго.
POST /v1/incontext/session разменя публикуваем ключ и Origin за токена на сесия с обхват.
improved
Двуезичният експорт вече докладва какво не е могло да бъде кръгово преведено, вместо тихо да замества изходния текст. Съществуващите полета остават непроменени, което е целта на поставянето им в заглавка.
GET /v1/pull получи заглавките на отговора X-Skipped-Keys и X-Missing-Source-Keys.
added
Освен /v1/glossary/import, /export и /extract, така че терминологичната база може да се премества вътре и навън без отваряне на конзолата.
Пълно CRUD управление на терминологичната база през API: GET, POST, PUT и DELETE за /v1/glossary.
added
Откритията попадат в редовете за превод, които вече изтегляте, така че няма нужда да се опитва ново анкетиране.
POST /v1/qa/run задейства агентска проверка на качеството и връща идентификатор на изпълнението.
added
Абонирайте се за крайна точка. Самият списък се намира в App\Enums\WebhookEvent, който днес съдържа дванадесет случая; бройте изброяването, а не този ред.
Подписаните уеб куки излъчват събития за ключове, преводи, езици, терминологични бази и QA заедно с оригиналната двойка пакети.
improved
Доставката носи брой и до двадесет примера, вместо едно обаждане за всеки променен ред. Дневниците за доставка записват всеки опит с времето на следващото повторение.
Често срещани събития като translation.updated се обединяват в едно доставяне за прозорец, така че масовото редактиране никога не затрупва крайната точка.
added
Връща ETag и краткотрайно кеширане и спазва If-None-Match със статус 304. Непроменливият вариант под /v{n} е адресиран по съдържание и се кешира за една година.
Публичен GET крайна точка /v1/cdn/{project}/{locale}, кешируема на ръба, обслужва публикуваните ви низове.
added
Извиквайте го в CI с POST /v1/cdn/publish и авторизирайте четенията със специален ключ само за четене в заглавката X-Transglot-Cdn-Key. Безопасно е да го поставите зад собствен CDN.
Публикуването повишава текущите преводи до нова непроменима версия, ръчно или при всяко изпращане.
added
Няма съхранени тела на заявки. Това е просто бройка и нищо повече.
Всеки удостоверен /v1 повикване се брои по токен на ден и се показва в хъба за разгръщане.
improved
Проект, изтегляне, партиди и експорт на глосар. Никаква форма на заявка или отговор не беше променена, за да работи.
Хъбът за разгръщане получи API playground, който изпълнява live крайни точки само за четене срещу вашия проект.
регистър на депрекации
Нищо не е премахвано.
Един ред за всяка публикувана повърхност, с изданието, което я е доставило. Последната колона е тази, която трябва да следите: премахване би се появило там с дата дълго преди действителното му настъпване.
| Повърхност | Доставено | Статус | Дата на премахване |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | текущ | няма планирани |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | текущ | няма планирани |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | текущ | няма планирани |
POST /v1/qa/run | June 12, 2026 | текущ | няма планирани |
Signed webhook events, twelve typed cases | June 30, 2026 | текущ | няма планирани |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | текущ | няма планирани |
Ред никога не се изтрива от тази таблица. Ако дадена повърхност бъде оттеглена, тя запазва реда си и получава дата, защото възможността за планиране спрямо премахването е основната цел на публикуването му.
гаранцията за съвместимост
Три правила върху които можете да градите.
адитивни
Нови крайни точки и нови полета в отговорите се пускат в рамките на /v1. Поле, което вече анализирате, не променя структурата си и не изчезва.
нов префикс
Критична промяна би била пусната под нов версионен префикс, а не в рамките на текущия. Този префикс е резервиран и неизползван, а всяка следваща версия е базирана на v1.
коректни заглавки
Когато заявка не може да обработи нещо напълно, тя го посочва в заглавка. X-Skipped-Keys и X-Missing-Source-Keys бяха добавени, вместо да се променя тялото на отговора.
ЧЗВ
Какво питат разработчиците за версионирането на API и оттеглянето на функции.
API на Transglot има ли версии?
Да, чрез префикс в URL. Всичко публикувано досега е достъпно под /v1, който е единственият използван префикс. Няма заглавка за версия, няма фиксиране по дата и нищо за конфигуриране.
Ще наруши ли някоя актуализация моята интеграция?
Не в рамките на /v1. Добавят се нови крайни точки и нови полета в отговора, но поле, което вече обработвате, не променя структурата си и не изчезва. Ако промяна не може да бъде направена добавъчно, тя се поставя под нов префикс, а старият продължава да работи.
Има ли нещо остаряло или премахнато?
Нищо, и горният регистър го потвърждава ред по ред. Всяка публикувана повърхност е изброена с версията, която я е включила, и колона за премахване, която навсякъде показва „не е планирано“.
Колко предупреждение ще се даде при премахване?
Премахването ще се появи в този регистър с дата дълго преди действителното му изпълнение и редът ще остане в таблицата след това, вместо да изчезне. Датата, спрямо която можете да планирате, е основната цел на публикуването му.
Как разбрам кога се пуска нещо ново?
Всяка версия е датирана на тази страница. Продуктовият дневник на промените обхваща всичко останало, което се пуска, а конзолата показва маркер, когато има нещо, което не сте прочели.
Защо има отделен дневник на промените за API?
Защото API носи обещание за съвместимост, което продуктовата версия не носи. Разработчик, проверяващ дали интеграцията все още работи, не трябва да преглежда информация за нови функции, за да разбере това.
Как да добавя API към моя план?
Токенът bearer започва от плана Starter на цена $19 на месец. Безплатният план покрива конзолата, но не позволява генериране на токен, а CLI, GitHub Action, уебкуковете и MCP са зад същия токен.
Къде е справочникът за самите крайни точки?
На страницата на API: удостоверяване, крайни точки, ограничение на скоростта, файлови формати и каталог с уебкукове. Тази страница е само запис на промените и кога са настъпили.
работи с това, което вече използвате
41 конектора, вече изградени.
договорът е продуктът
Изградете върху API което не се променя.
API е достъпно за планове Starter и по-високи. Безплатният план е $0 с 100 000 думи за начало (25 000 при регистрация, 75 000 след телефонна проверка), 10 000 на месец след това и без API или уеб куки.