Быстрый старт: проект и ключи
Все песочницы на этом сайте работают с общим демонстрационным проектом, поэтому изучать возможности можно без аккаунта. Чтобы перевести собственное приложение, понадобятся три вещи из панели управления Langsys: проект, ключ для записи и ключ только для чтения. Две минуты, и всего один раз.
Настройка
- Войдите на app.langsys.dev — или создайте аккаунт, если его ещё нет.
- Создайте проект. Выберите базовую локаль (язык, на котором написаны ваши исходные фразы) и целевые локали, для которых нужны переводы. Скопируйте идентификатор проекта.
- Создайте два API-ключа для проекта: один ключ для записи и один ключ только для чтения. Такое разделение — основа всей модели безопасности, а раздел «Ключи и окружения» объясняет почему.
- Добавьте их в своё окружение и установите 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:
Фронтенд
TypeScript, React, Vue и Svelte — у каждого есть интерактивная песочница.
Бэкенд
PHP и Laravel — страница приходит уже локализованной.
Мета-фреймворки
Next.js, Nuxt и SvelteKit — заполняйте данные на сервере, гидратируйте на клиенте.
Впервые сталкиваетесь с базовыми идеями? Начните с раздела Концепции — фраза как ключ, обнаружение токенов и хранилище локалей — а затем возвращайтесь сюда.