api.transglot.ai/v1токен носія, один проєктдовідка

Надішліть файл. Отримайте всі мови назад.

REST API для перекладу вашого застосунку. Один POST завантажує вихідний файл, один GET повертає готову локаль, а токен носія — це вся автентифікація. Будь-який клієнт, що підтримує HTTP, може ним керувати.

вхід: один виклик

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

вихід

300,000

слів на місяць у плані Starter, перший план, що дозволяє створювати токен.

Почати безкоштовно Переглянути інтерфейс для розробників

60 запитів на хвилину на токен · кожна відповідь 429 містить заголовок Retry-After · використовуйте окремі токени для CI та продакшену

консоль — це клієнт API

Надсилайте, перекладайте, перевіряйте та отримуйте, кожна дія — це REST-ендпоінт.

За кожним рядком на зображенні нижче стоїть маршрут: надсилання, перевірки, глосарій, пакети та отримання. До всіх них можна звернутися з вашого коду за допомогою токена проєкту. Пісочниця API в консолі виконує запити лише на читання в реальному часі проти вашого проєкту, щоб ви одразу побачили справжню відповідь.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Ви завантажуєте вихідний файл
POST/v1/push
Панель перевірок заповнюється
POST/v1/qa/run
Ви блокуєте термін
POST/v1/glossary
Вигляд пакета опитується автоматично
GET/v1/batches/:id
Ви отримуєте переклади назад
GET/v1/pull

один маршрут на панель, 60 на хвилину, можливості на токен · експорт перекладів також доступний через ендпоінт

це просто HTTP

Чотири речі, які команди будують першими.

кожна з них — це один ендпоінт і токен проєкту · жодна не займає цілий день

merge gate · один файл робочого процесу

Зробіть pull request червоним, якщо переклад не пройшов перевірку.

cron · щовечора

Перекладайте нотатки до релізу вночі, кожної ночі.

бот · одна підписка

Публікуйте повідомлення в Slack, як тільки пакет завершено.

агент · MCP

Надайте AI-агенту ті самі 17 інструментів, що й вам.

запитів на хвилину

на токен, а не на обліковий запис, із заголовком Retry-After у кожній відповіді 429, який вказує кількість секунд очікування.

формати файлів

використовуйте той самий формат, що й у вашому репозиторії. Множинні форми та заповнювачі зберігаються в обох напрямках. Вкажіть його через format= у будь-якому запиті.

події вебхуків

усьому каталозі, кожна з прикладом корисного навантаження саме в тому вигляді, в якому воно надходить. GET /v1/webhooks/events.

інструменти MCP

той самий токен проєкту, переданий середовищу виконання агента замість curl. npx -y @transglot/mcp.

Часті запитання

Що розробники питають перед першим запитом.

Як автентифікуватися в API Transglot?

Надішліть bearer-токен: Authorization: Bearer $TRANSGLOT_TOKEN. Токен належить одному проєкту, тому в шляху немає project id і немає загального ключа облікового запису, який можна було б скомпрометувати. Ви створюєте токени на сторінці проєкту, і кожен із них має власні можливості: push, pull, manage, read, write.

Чи безкоштовний API?

Ні. Bearer-токен починається з плану Starter за 19 доларів на місяць. Безкоштовний доступ охоплює консоль, чого достатньо, щоб зрозуміти, чи підходить вам продукт, але він не дозволяє створити токен. CLI, дія GitHub, вебхуки, MCP і пакет доставки працюють через той самий токен, тому вони доступні разом.

Як завантажити рядки в Transglot?

POST /v1/push із файлом і його форматом, наприклад -F "file=@lang/en.json" -F "format=laravel_json". Відповідь 202 і постановка в чергу пакета. Перекладаються лише ті рядки, які справді змінилися, тому надсилання незміненого файлу нічого не коштує.

Як отримати свої переклади назад?

GET /v1/pull, у будь-якому з 20 форматів, коли завгодно. Це кінцева точка, яку огортає CLI і яку API playground виконує в реальному часі. Немає потреби подавати запит на експорт і немає вікна, коли дані перестають бути вашими.

Яке обмеження швидкості API?

60 запитів на хвилину, що враховуються для кожного токена окремо, а не для всього облікового запису. Якщо перевищено ліміт, ви отримаєте 429 із заголовком Retry-After, де вказано, скільки секунд чекати, і нічого не буде зараховано або записано частково. Використовуйте окремі токени для CI та продакшену, щоб шумна збірка не блокувала вашу програму.

Які мови підтримує API?

Немає фіксованого списку. Валідатор приймає будь-який тег BCP-47, який розпізнає ICU, а це 708 локалей у таблиці, проти якої він перевіряє, плюс структурний резервний варіант для тегів поза нею. Додайте локаль до проєкту, і наступне надсилання включатиме її.

Які формати файлів можна надсилати та отримувати?

Двадцять: JSON плоский і вкладений, Laravel PHP і JSON, Android XML, iOS .strings, .stringsdict і .xcstrings, Flutter ARB, XLIFF 1.2 і 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV і Unreal PO. Сім із них підтримують множинні форми, і файл повертається в тому ж вигляді, в якому був надісланий.

Чи є в Transglot вебхуки?

Так. Є 12 подій вебхуків, включаючи batch.completed, translation.reviewed, qa.completed і source_drift.repaired. Кожна доставка підписана HMAC із заголовком часової мітки, щоб ви могли її перевірити, а GET /v1/webhooks/events повертає каталог із зразком корисного навантаження для кожної з них.

Чи є сервер MCP для AI-агентів?

Так. npx -y @transglot/mcp надає доступ до 17 інструментів через токен вашого проєкту, тож помічник може читати переклад, писати його, додавати мову, запускати виконання, перевіряти пакет або редагувати глосарій. Це той самий API та ті самі дозволи, лише доступ здійснюється з середовища виконання агента, а не через curl.

Чи можна запустити його в CI?

Так. Дія GitHub (transglot/transglot-action@v1) і CLI обгортають ці кінцеві точки. Якщо рядок відхилено, transglot push --wait завершується з кодом 4, а дія позначає завдання як невдале для цього запуску. Щоб заблокувати злиття, запускайте його на пул-реквестах із параметром commit, встановленим у none, додайте крок, який завершується помилкою, якщо у витягнутому файлі відсутній ключ, і зробіть це завдання обов’язковою перевіркою в захисті гілки.

Що стається, коли переклад не проходить перевірку якості?

Чотири детерміновані шлюзи перевіряють кожен рядок: заповнювачі, множинні форми, терміни глосарію та довжину. Пошкоджений заповнювач, відсутня множина або заборонений термін глосарію отримують одну автоматичну спробу виправлення; якщо вона також не вдається, рядок відхиляється, а не записується. Рядок, який лише перевищує обмеження довжини, записується, а не відхиляється. GET /v1/batches/:id?include=failures повертає список відхилених рядків і причини відмови.

Чи може API зламати мою інтеграцію?

Ні. /v1 лише додає нові ендпоінти та поля відповіді; поле, яке ви вже обробляєте, не змінює структуру й не зникає. Критична зміна вийшла б під новим префіксом версії, який зарезервовано й поки що порожній. Журнал змін API фіксує кожен реліз.

працює з тим, що ви вже використовуєте