← Leren

Snelstart: project & sleutels

Elke playground op deze site draait op een gedeeld demoproject, zodat je kunt verkennen zonder account. Om je eigen app te vertalen heb je drie dingen nodig uit het Langsys-dashboard: een project, een schrijfsleutel en een alleen-lezensleutel. Twee minuten, eenmalig.

De installatie

1. Log in op app.langsys.dev; maak een account aan als je er nog geen hebt.
2. Maak een project aan. Kies de basislocale (de taal waarin je brontekstzinnen zijn geschreven) en de doellocales waarvoor je vertalingen wilt. Kopieer de project-id.
3. Maak twee API-sleutels aan voor het project: één schrijfsleutel en één alleen-lezensleutel. Die splitsing vormt het hele beveiligingsmodel — Sleutels en omgevingen legt uit waarom.
4. Zet ze in je env en installeer de SDK voor jouw stack. Ontwikkel met de schrijf-key, zodat nieuwe zinnen tijdens het bouwen worden geregistreerd en automatisch vertaald; lever de app uit met de alleen-lezen key.

# .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)

Kies vervolgens je SDK

Elke SDK-pagina begint bij Installeren en gaat uit van precies deze setup — project-id en sleutel in je env:

Ben je nieuw met de onderliggende ideeën? Begin met Concepten — de zin is de sleutel, tokenontdekking en de locale-opslag — en kom daarna hier terug.