Vinnige begin

API-weergawe 2026-10-affable-towhee

Vyf stappe van niks tot 'n gestroomde woordelys: skep 'n kliënt, sit dit in jou shell, ruil dit in vir 'n toegangtoken, maak een oproep, en kry 'n nuwe token wanneer dit verval.

1. Skep 'n kliënt

Skep op die Integrasies-bladsy van die Lingara-webtoep, by app.getlingara.com/admin, onder OAuth-kliënte, 'n kliënt wat Genereer woordeskat mag doen (die omvang vocab:generate). Kopieer sy kliënt-ID en sy geheim. Die geheim word slegs een keer gewys.

2. Sit dit in jou shell

Stoor die kliënt-ID en geheim in die omgewingsveranderlikes LINGARA_CLIENT_ID en LINGARA_CLIENT_SECRET, sodat geen geheim ooit in 'n opdrag geskryf word nie.

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

3. Kry 'n toegangtoken

Hierdie opdrag ruil die kliënt in vir 'n toegangtoken en hou dit in LINGARA_TOKEN, wat elke voorbeeld in hierdie verwysing lees. Dit benodig jq en curl 7.76 of later. As die inruiling misluk, druk die opdrag die foutkode (byvoorbeeld invalid_client: gaan die ID en geheim na) en laat LINGARA_TOKEN leeg, sodat die volgende oproep met 401 misluk totdat 'n inruiling slaag. Sonder jq: voer die inruiling uit die Verifikasie-gids uit en kopieer access_token met die hand uit die 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 'n woordelys

Voer hierdie opdrag uit. -N skakel curl se buffering af, sodat elke gebeurtenis gedruk word sodra dit aankom.

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 jy behoort te sien

'n started-gebeurtenis met die lys se besonderhede, een item-gebeurtenis per woord, en dan done. Jou woorde sal van hierdie voorbeeld verskil.

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. Wanneer die uur verby is

Die oproep antwoord met 401. Voer stap 3 weer uit. As stap 3 nou misluk, het die kliënt of sy geheim op die Integrasies-bladsy verander. 'n Program volg die Verifikasie-gids se reël: ruil een keer per 401 weer in, en hou op as die inruiling misluk.

Indien 'n vertaling en die Engelse verwysing verskil, is die Engelse verwysing korrek.