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.