Ключі та середовища
Проєкт Langsys видає два типи API-ключів. Який із них використовувати, залежить від того, чи ви виявляєте нові фрази (розробка), чи просто показуєте готові переклади (production). Обидва створюються в панелі керування — Швидкий старт проведе вас крок за кроком.
Два ключі — два завдання
| Тип ключа | Можливості | Використовуйте в |
|---|---|---|
| Запис | Отримуйте переклади і реєструйте нововиявлені фрази в проєкті. | Розробка / серверна сторона. Не додавайте до публічних бандлів. |
| Лише читання | Лише отримання перекладів. Не може нічого реєструвати чи змінювати. | Продакшн / браузер. Безпечно додавати в клієнтський код. |
Чому ключ лише для читання безпечний у браузері. Він фізично не може записувати — найгірше, що з ним можна зробити, це прочитати ті самі публічні переклади, які вже бачать ваші користувачі. У цьому й полягає сенс розділення.
Типовий процес
- Розробляйте з ключем запису. Поки ви створюєте інтерфейс, нові фрази виявляються, реєструються та автоматично перекладаються на ваші цільові локалі.
- Щойно текст стане остаточним, переведіть розгорнутий застосунок на ключ лише для читання.
- Користувачі отримують готовий каталог; ніщо з того, чим вони володіють, не може змінити ваш проєкт.
# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key # discovers + registers new phrases# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key # only fetches — safe to shipЩо містить проєкт
Ключ автентифікується в межах проєкту, який визначає набір перекладів для вашого застосунку:
- базова локаль — мова, якою написано ваші вихідні фрази;
- набір цільових локалей — усіх мов, на які фрази перекладаються машинним перекладом;
- налаштування машинного перекладу — рівень провайдера та чи перекладаються нові фрази автоматично.
Запускаєте ці демо локально? Спрямуйте SDK на власний екземпляр за допомогою ключа лише для читання — див. .env.example у проєкті. Інакше панелі працюватимуть у демо-режимі (лише вихідний текст).