API lokalizacji React i zarządzanie (zgodne z i18next)

Lokalizacja.One bezproblemowo integruje się z nowoczesnymi frameworkami frontendowymi. Zamiast zarządzać ogromnymi, podatnymi na konflikty plikami JSON w swoim repozytorium Git, możesz przesyłać tłumaczenia bezpośrednio do swojej aplikacji React, Vue lub Angular.

Dlaczego programiści wybierają nasze API React?

  • Czysty format JSON: Generujemy standardowy obiekt klucz-wartość ({ "key": "value" }) zgodny z i18next, react-intl, vue-i18ni innymi popularnymi bibliotekami.
  • Niezależność od frameworka: Choć idealny dla React, ten format działa natywnie z Vue.js, Angular, Svelte i backendami Node.js.
  • Bez konfliktów: Przestań ręcznie scalać pliki JSON. Pozwól swojemu zespołowi edytować tłumaczenia w naszym interfejsie użytkownika i po prostu pobierz ostateczny plik podczas budowy.

Zaawansowane zarządzanie projektami

Skaluj swoją lokalizację frontendową bez bólu głowy.

Przestrzenie nazw: Użyj Kategorii , aby zorganizować ciągi w osobnych plikach (np. common.json, home.json, validation.json), aby wspierać leniwe ładowanie.

Etykiety i tagi: Oznacz ciągi niestandardowymi etykietami, aby filtrować eksporty przez API.

Współpraca zespołowa: Zaproś projektantów i copywriterów. Przypisz szczegółowe role (Właściciel, Administrator, Menedżer, Tłumacz).

Webhooki: Automatycznie uruchamiaj Vercel lub Netlify budowy, gdy tłumaczenia są aktualizowane.

Jak zintegrować

Opcja 1: Ręczny eksport (UI)

Idealne do lokalnego rozwoju lub testowania.

  1. Przejdź do swojego Panelu projektu.
  2. Kliknij przycisk Pobierz .
  3. Wybierz JSON (czysty) z rozwijanego menu formatu.
  4. Wybierz język i pobierz plik .json.

Opcja 2: Automatyzacja za pomocą API (CI/CD)

Pobierz najnowsze tłumaczenia bezpośrednio w swoich skryptach package.json lub w pipeline CI. Przekaż parametr format=json-clean.

# Pobierz tłumaczenia angielskie
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=json-clean" > src/locales/en/translation.json

# Pobierz tłumaczenia hiszpańskie
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=2&format=json-clean" > src/locales/es/translation.json

Opcja 3: Wysyłanie przez webhooki

Skonfiguruj URL webhooka w ustawieniach projektu, aby całkowicie zautomatyzować proces.

  • Szybkie aktualizacje: Twój serwer otrzymuje żądanie POST krótko po zmianach (zwykle w ciągu 5 minut).
  • Uruchamiaj budowy: Połącz webhooki z dostawcą CI/CD (GitHub Actions, GitLab CI), aby automatycznie odbudować frontend, gdy zawartość się zmienia.

Najczęściej zadawane pytania

Czy to działa z Next.js?

Tak. Ponieważ Next.js używa standardowych plików JSON do internacjonalizacji (i18n), możesz po prostu pobrać nasz format json-clean do folderu public/locales podczas procesu budowy.

Czy mogę używać zagnieżdżonych kluczy?

Obecnie eksportujemy płaską strukturę klucz-wartość, która działa doskonale z i18next. Jeśli wolisz zagnieżdżony JSON (np. home.title), możesz przetworzyć plik po pobraniu lub użyć notacji kropkowej w swoich kluczach (home.title).

Również istotne dla programistów webowych:

Gotowy, aby zautomatyzować swoją lokalizację frontendową? Utwórz swoje darmowe konto już dziś.