API локализации React и управление (совместимо с i18next)

Localization.One без усилий интегрируется с современными фреймворками фронтенда. Вместо того чтобы управлять огромными, подверженными конфликтам JSON-файлами в вашем репозитории Git, вы можете передавать переводы напрямую в ваше приложение на React, Vue или Angular.

Почему разработчики выбирают наш API для React?

  • Чистый формат JSON: Мы генерируем стандартный объект ключ-значение ({ "key": "value" }), совместимый с i18next, react-intl, vue-i18nи другими популярными библиотеками.
  • Независимость от фреймворка: Хотя это идеально подходит для React, этот формат работает нативно с Vue.js, Angular, Svelte и бэкендами на Node.js.
  • Без конфликтов: Перестаньте вручную объединять JSON-файлы. Позвольте вашей команде редактировать переводы в нашем интерфейсе, и просто извлеките финальный файл во время сборки.

Расширенное управление проектом

Масштабируйте вашу локализацию фронтенда без головной боли.

Пространства имен: Используйте Категории для организации строк в отдельные файлы (например, common.json, home.json, validation.json) для поддержки ленивой загрузки.

Метки и теги: Помечайте строки пользовательскими метками для фильтрации экспорта через API.

Сотрудничество в команде: Приглашайте дизайнеров и копирайтеров. Назначайте детализированные роли (Владелец, Администратор, Менеджер, Переводчик).

Webhooks: Автоматически запускайте сборки Vercel или Netlify при обновлении переводов.

Как интегрировать

Вариант 1: Ручной экспорт (UI)

Идеально подходит для локальной разработки или тестирования.

  1. Перейдите на вашу панель управления проектом.
  2. Нажмите кнопку Скачать .
  3. Выберите JSON (Чистый) из выпадающего списка форматов.
  4. Выберите язык и скачайте файл .json.

Вариант 2: Автоматизация с помощью API (CI/CD)

Получите последние переводы напрямую в ваших скриптах package.json или CI-пайплайне. Передайте параметр format=json-clean.

# Скачать английские переводы
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=json-clean" > src/locales/en/translation.json

# Скачать испанские переводы
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=2&format=json-clean" > src/locales/es/translation.json

Вариант 3: Отправка через Webhooks

Настройте URL Webhook в настройках вашего проекта, чтобы полностью автоматизировать процесс.

  • Быстрые обновления: Ваш сервер получает POST-запрос вскоре после изменений (обычно в течение 5 минут).
  • Запуск сборок: Подключите вебхуки к вашему провайдеру CI/CD (GitHub Actions, GitLab CI), чтобы автоматически пересобирать ваш фронтенд при изменении контента.

Часто задаваемые вопросы

Работает ли это с Next.js?

Да. Поскольку Next.js использует стандартные JSON-файлы для интернационализации (i18n), вы можете просто получить наш формат json-clean в вашу папку public/locales во время процесса сборки.

Могу ли я использовать вложенные ключи?

В настоящее время мы экспортируем плоскую структуру ключ-значение, которая идеально работает с i18next. Если вы предпочитаете вложенный JSON (например, home.title), вы можете обработать файл после загрузки или использовать точечную нотацию в ваших ключах (home.title).

Также актуально для веб-разработчиков:

Готовы автоматизировать вашу локализацию фронтенда? Создайте свою бесплатную учетную запись сегодня.