← Навчання

Швидкий старт: проєкт і ключі

Усі playground-середовища на цьому сайті працюють із спільним демопроєктом, тож досліджувати їх можна без облікового запису. Щоб перекласти власний застосунок, вам знадобляться три речі з панелі керування Langsys: проєкт, ключ для запису та ключ лише для читання. Дві хвилини, один раз.

Налаштування

1. Увійдіть на app.langsys.dev — створіть обліковий запис, якщо його ще немає.
2. Створіть проєкт. Виберіть базову локаль (мову, якою написано ваші вихідні фрази) та цільові локалі, для яких потрібні переклади. Скопіюйте ідентифікатор проєкту.
3. Згенеруйте два API-ключі для проєкту: один ключ для запису і один ключ лише для читання. Це розділення — основа всієї моделі безпеки; чому так, пояснює розділ Ключі та середовища.
4. Додайте їх до свого середовища та встановіть SDK для свого стека. Розробляйте з ключем для запису, щоб нові фрази реєструвалися й автоматично перекладалися в процесі роботи; у реліз віддавайте ключ лише для читання.

# .env.local — development (Vite-style names; adjust the prefix to your bundler)
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 in the browser

# .env (Laravel, or your PHP app's environment)
LANGSYS_PROJECT_ID=your-project-id
LANGSYS_API_KEY=write-key            # server-side, so the write key can stay —
                                     # switch to read-only anywhere that must not
                                     # register phrases (e.g. a public sandbox)

Потім оберіть свій SDK

Кожна сторінка SDK починається з розділу Встановлення і припускає саме таке налаштування — ідентифікатор проєкту та ключ у вашому env:

Нове для вас те, що лежить в основі? Почніть із розділу Концепції — фраза як ключ, виявлення токенів і сховище локалей — а потім поверніться сюди.