API — начало работы

Токены

1. Создайте токен

Перейдите в Настройки → API-токены и создайте токен. Токен показывается один раз, поэтому сразу скопируйте его. Токен можно ограничить одним проектом или оставить для всего аккаунта.

2. Авторизация

Передавайте токен в заголовке Bearer в каждом запросе:

Authorization: Bearer loc_…

Примеры

Экспорт языка

$ curl -H "Authorization: Bearer $LOCALIZIFY_TOKEN" \
  "https://localizify.com/api/v1/projects/123/export?provider=Angular%20XLIFF&langCode=uk" \
  -o messages.uk.xlf

Загрузка новых терминов

$ curl -X POST -H "Authorization: Bearer $LOCALIZIFY_TOKEN" \
  -H "Content-Type: application/json" \
  "https://localizify.com/api/v1/projects/123/terms" \
  -d '{"terms":[{"key":"app.title","source":["My App"],"context":"Window title"}]}'

Перевод с помощью ИИ

$ curl -X POST -H "Authorization: Bearer $LOCALIZIFY_TOKEN" \
  -H "Content-Type: application/json" \
  "https://localizify.com/api/v1/projects/123/translate" \
  -d '{"provider":"anthropic","langCodes":["uk","de"]}'

Использует ваш собственный ключ провайдера, если вы добавили его в разделе Ключи ИИ-провайдеров; в этом случае символы AT не списываются.

Выгрузка всех языков в CI

# In CI: pull every language after translators finish
for LANG in en uk de; do
  curl -sf -H "Authorization: Bearer $LOCALIZIFY_TOKEN" \
    "https://localizify.com/api/v1/projects/123/export?provider=Angular%20XLIFF&langCode=$LANG" \
    -o "src/locale/messages.$LANG.xlf"
done

Инструмент командной строки

CLI использует тот же API для скриптов и CI. Он берёт токен из LOCALIZIFY_TOKEN, а структуру файлов из localizify.json.

# localizify.json lists the source file and one entry per language
$ npx @localizify/cli push        # upload new keys
$ npx @localizify/cli translate   # AI-translate what is still untranslated
$ npx @localizify/cli pull        # write the translated files

Формат конфигурации и все параметры

Подключение ИИ-ассистентов (MCP)

Localizify является удалённым MCP-сервером. Подключите Claude Code, Cursor или любой MCP-клиент и попросите его показать проекты, добавить ключи, перевести их с помощью ИИ, отредактировать переводы или загрузить и выгрузить файлы. Используются тот же API-токен, области доступа и лимиты, что и в REST API.

Claude.ai и ChatGPT

Добавьте пользовательский коннектор с URL https://localizify.com/mcp. Вам предложат войти в Localizify и выбрать, получит ли ассистент доступ ко всем проектам или только к одному. Копировать токен не нужно. Отключить доступ можно в любой момент, отозвав его в разделе Настройки → API-токены.

Claude Code

$ claude mcp add --transport http localizify https://localizify.com/mcp \
  --header "Authorization: Bearer $LOCALIZIFY_TOKEN"

Cursor и другие клиенты

{
  "mcpServers": {
    "localizify": {
      "url": "https://localizify.com/mcp",
      "headers": { "Authorization": "Bearer loc_…" }
    }
  }
}

Токен, ограниченный одним проектом, даёт ассистенту доступ только к этому проекту.

Лимиты запросов

Лимиты считаются для каждого токена. Каждый ответ содержит X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset; при превышении лимита возвращается 429 с Retry-After.