added
Модель ключа розгортання, де токен-носій ІДЕНТИФІКУЄ проєкт. Саме на ній працюють CLI та дія GitHub.
api v1 · поточна
Журнал змін API.
Нічого не видалено.
/v1 лише додає нове. Нові ендпоінти та поля відповіді з’являються в межах того самого префікса, а поле, яке ви вже обробляєте, ніколи не змінює структуру й не зникає. Критична зміна вийшла б під новим префіксом версії, який зарезервовано й поки що порожній.
v1/api/v1
єдиний префікс у використанні
єдиний префікс у використанні
5 релізів
11 змін, жодна з них не є критичною
структура журналу
Один префікс версії, без видалень.
Три з цих чотирьох показників стосуються самого журналу. Четвертий — розмір каталогу вебхуків, які надає API.
5
релізи на /v1, кожен із них лише додає нове
1
префікс версії у використанні. Наступний зарезервовано й він порожній
0
критичних змін від моменту запуску API
12
подій із підписаними вебхуками. Джерело: App\Enums\WebhookEvent
датовано за релізами, а не за semver
використовуйте клавіші зі стрілками для навігації
2026-07-08
Доставка через CDN, використання та пісочниця
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, який сьогодні має дванадцять варіантів; орієнтуйтеся на кількість елементів у переліку, а не на цей рядок.
Підписані вебхуки надсилають події ключів, перекладів, мов, глосарію та перевірки якості разом із початковою парою пакетів.
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.
Публікація переводить поточні переклади в нову незмінну версію, вручну або після кожного push.
added
Тіла запитів не зберігаються. Це лише лічильник і нічого більше.
Кожен автентифікований виклик /v1 враховується щодня для кожного токена та відображається на хабу розгортання.
improved
Проєкт, pull, пакети та експорт глосарію. Жодна форма запиту чи відповіді не змінилася, щоб це працювало.
Центр розгортання отримав майданчик API, який запускає read-only ендпоінти в реальному часі проти вашого проєкту.
реєстр застарілих функцій
Нічого не буде видалено.
Один рядок для кожного опублікованого інтерфейсу з релізом, у якому його було випущено. Останній стовпець — той, за яким слід стежити: видалення з’явиться там із датою задовго до того, як воно станеться.
| Інтерфейс | Випущено | Статус | Дата видалення |
|---|---|---|---|
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.
чесні заголовки
Коли pull-запит не може коректно обробити дані, він повідомляє про це в заголовку. X-Skipped-Keys та X-Missing-Source-Keys були додані, щоб уникнути зміни тіла запиту без попередження.
Часті запитання
Що розробники питають про версіонування API та застарівання функцій.
Чи є Transglot API версіонованим?
Так, за префіксом URL. Усе, що опубліковано досі, знаходиться під /v1, який є єдиним використовуваним префіксом. Немає заголовка версії, прив’язки до дати чи налаштувань.
Чи може оновлення коли-небудь зламати мою інтеграцію?
Ні, всередині /v1. Додаються нові кінцеві точки та нові поля відповіді, але поле, яке ви вже обробляєте, не змінює структуру і не зникає. Якщо зміну неможливо зробити адитивно, вона перейде під новий префікс, а старий продовжить працювати.
Чи щось було застаріло або видалено?
Нічого, і реєстр вище підтверджує це рядок за рядком. Кожна опублікована поверхня перелічена з релізом, у якому вона з’явилася, та колонкою видалення, де зараз усюди написано «не заплановано».
Яке попередження буде перед видаленням?
Видалення з’явилося б у цьому реєстрі з датою, що значно випереджає фактичну подію, а рядок залишався б у таблиці, замість того щоб зникнути. Дата, на яку можна орієнтуватися при плануванні, — це головна мета публікації.
Як дізнатися про нові випуски?
Кожен реліз має дату на цій сторінці. Журнал змін продукту охоплює все інше, що випускається, а в консолі з’являється позначка, якщо є щось, чого ви ще не читали.
Чому для API є окремий журнал змін?
Тому що API має гарантії сумісності, яких немає у релізі продукту. Розробник, який перевіряє, чи працює інтеграція далі, не повинен прогортати функціональні оновлення, щоб знайти потрібну інформацію.
Як додати API до свого плану?
Маркер доступу (bearer token) починається з плану Starter за $19 на місяць. Безкоштовний план охоплює консоль, але не дозволяє створювати маркер, а CLI, дія GitHub, вебхуки та MCP потребують цього самого маркера.
Де знаходиться довідка щодо самих кінцевих точок?
На сторінці API: автентифікація, кінцеві точки, обмеження швидкості, формати файлів і каталог вебхуків. Ця сторінка містить лише запис про те, що змінилося і коли.
працює з тим, що ви вже використовуєте
41 конекторів уже готово.
контракт — це продукт
Створення на основі API який не змінюється.
API доступний на плані Starter і вище. Безкоштовний план коштує $0 і включає 100 000 слів для початку (25 000 під час реєстрації, 75 000 після перевірки телефону), потім 10 000 на місяць, без доступу до API та вебхуків.