api.transglot.ai/v1bearer-токен, один проектсправка

Отправьте файл. Получите все языки обратно.

REST API для перевода вашего приложения. Один POST загружает исходный файл, один GET возвращает готовую локаль, а bearer-токен — это вся необходимая аутентификация. Любой клиент, поддерживающий 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 · один файл рабочего процесса

Делайте пул-реквест красным, если перевод не прошел проверку.

cron · каждую ночь

Переводите примечания к релизу каждую ночь.

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

Отправляйте сообщение в Slack, как только пакет будет готов.

агент · MCP

Дайте ИИ-агенту те же 17 инструментов, что и вам.

запросов в минуту

на токен, а не на аккаунт, с заголовком Retry-After в каждом ответе 429, указывающим количество секунд ожидания.

форматы файлов

отправляйте и получайте данные в формате, который уже используется в вашем репозитории. Множественные числа и подстановочные знаки сохраняются в обоих направлениях. Указывайте формат через format= в любом запросе.

события вебхуков

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

инструментов MCP

тот же токен проекта, передаваемый среде выполнения агента вместо curl. npx -y @transglot/mcp.

Частые вопросы

Что спрашивают разработчики перед первым запросом.

Как выполнить аутентификацию в API Transglot?

Отправьте bearer-токен: Authorization: Bearer $TRANSGLOT_TOKEN. Токен привязан к одному проекту, поэтому в пути нет идентификатора проекта и нет ключа уровня аккаунта, который можно было бы скомпрометировать. Вы создаете токены на странице проекта, и каждый из них имеет свои собственные права: 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. Нет необходимости подавать запрос на экспорт, и ваши данные всегда остаются у вас.

Каков лимит запросов к 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 для ИИ-агентов?

Да. npx -y @transglot/mcp предоставляет 17 инструментов через токен вашего проекта, поэтому ассистент может читать переводы, создавать их, добавлять языки, запускать выполнение, проверять пакет или редактировать глоссарий. Это тот же API и те же разрешения, но доступ к ним осуществляется из среды выполнения агента, а не через curl.

Можно ли использовать его в CI?

Да. Действие GitHub (transglot/transglot-action@v1) и CLI являются оболочками для этих конечных точек. Если строка отклонена, transglot push --wait завершается с кодом 4, и действие завершает задание с ошибкой в этом выполнении. Чтобы остановить слияние, запускайте его для pull-запросов с параметром commit, установленным в none, добавьте шаг, который завершается ошибкой, если в полученном файле отсутствует ключ, и сделайте это задание обязательной проверкой в защите веток.

Что происходит, если перевод не проходит проверку качества?

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

Может ли API сломать мою интеграцию?

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

работает с тем, что вы уже используете