Snelstart

API-versie 2026-10-affable-towhee

Vijf stappen van niets naar een gestreamde woordenlijst: maak een client aan, zet hem in je shell, ruil hem in voor een toegangstoken, doe één aanroep en haal een nieuw token wanneer het verloopt.

1. Maak een client aan

Maak op de pagina Integraties van de Lingara-webapp, op app.getlingara.com/admin, onder OAuth-clients een client aan die 'Woordenschat genereren' mag (de scope vocab:generate). Kopieer de client-ID en het geheim. Het geheim wordt maar één keer getoond.

2. Zet het in je shell

Sla de client-ID en het geheim op in de omgevingsvariabelen LINGARA_CLIENT_ID en LINGARA_CLIENT_SECRET, zodat er nooit een geheim in een commando wordt geschreven.

export LINGARA_CLIENT_ID="<your client id>"
export LINGARA_CLIENT_SECRET="<your client secret>"

3. Haal een toegangstoken op

Dit commando ruilt de client in voor een toegangstoken en bewaart het in LINGARA_TOKEN, dat elk voorbeeld in deze referentie leest. Het vereist jq en curl 7.76 of nieuwer. Mislukt de inruil, dan toont het commando de foutcode (bijvoorbeeld invalid_client: controleer de ID en het geheim) en laat het LINGARA_TOKEN leeg, zodat de volgende aanroep mislukt met 401 totdat een inruil slaagt. Zonder jq voer je de inruil uit de handleiding Authenticatie uit en kopieer je access_token met de hand uit het antwoord.

export LINGARA_TOKEN="$(curl -sS --fail-with-body -X POST "https://api.getlingara.com/oauth/token" \
  -u "$LINGARA_CLIENT_ID:$LINGARA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  --data-urlencode "scope=vocab:generate" | jq -r '.access_token // error(.error)')"

4. Genereer een woordenlijst

Voer dit commando uit. -N schakelt de buffering van curl uit, zodat elk event wordt getoond zodra het binnenkomt.

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

Wat je zou moeten zien

Een started-event met de details van de lijst, één item-event per woord en daarna done. Jouw woorden zullen afwijken van dit voorbeeld.

event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}

event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好，我叫小明。","translation":"Hello, my name is Xiaoming."}}

event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}

event: done
data: {}

5. Als het uur voorbij is

De aanroep antwoordt met 401. Voer stap 3 opnieuw uit. Mislukt stap 3 nu, dan is de client of zijn geheim gewijzigd op de pagina Integraties. Een programma volgt de regel uit de handleiding Authenticatie: ruil één keer opnieuw in per 401, en stop als de inruil mislukt.

Als een vertaling afwijkt van de Engelse referentie, is de Engelse referentie juist.