Pika-aloitus

API-versio 2026-10-affable-towhee

Viisi vaihetta tyhjästä suoratoistettuun sanastolistaan: luo asiakas, tallenna se komentotulkkiisi, vaihda se käyttöoikeustunnukseen, tee yksi kutsu ja hanki uusi tunnus, kun se vanhenee.

1. Luo asiakas

Luo Lingara-verkkosovelluksen Integraatiot-sivulla osoitteessa app.getlingara.com/admin, kohdassa OAuth-asiakkaat, asiakas, jolle sallitaan Luo sanastoa (oikeuslaajuus vocab:generate). Kopioi sen asiakastunniste ja salaisuus. Salaisuus näytetään vain kerran.

2. Tallenna se komentotulkkiisi

Tallenna asiakastunniste ja salaisuus ympäristömuuttujiin LINGARA_CLIENT_ID ja LINGARA_CLIENT_SECRET, jotta salaisuutta ei koskaan kirjoiteta komentoon.

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

3. Hanki käyttöoikeustunnus

Tämä komento vaihtaa asiakkaan käyttöoikeustunnukseen ja tallentaa sen muuttujaan LINGARA_TOKEN, jota jokainen tämän viitteen esimerkki lukee. Se tarvitsee työkalun jq ja curlin version 7.76 tai uudemman. Jos vaihto epäonnistuu, komento tulostaa virhekoodin (esimerkiksi invalid_client: tarkista tunniste ja salaisuus) ja jättää muuttujan LINGARA_TOKEN tyhjäksi, joten seuraava kutsu epäonnistuu tilakoodilla 401, kunnes vaihto onnistuu. Ilman työkalua jq suorita vaihto Todennus-oppaan ohjeen mukaan ja kopioi access_token vastauksesta käsin.

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. Luo sanastolista

Suorita tämä komento. -N poistaa curlin puskuroinnin käytöstä, joten jokainen tapahtuma tulostuu heti saapuessaan.

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}'

Mitä sinun pitäisi nähdä

started-tapahtuma listan tietoineen, yksi item-tapahtuma sanaa kohden ja lopuksi done. Omat sanasi poikkeavat tästä esimerkistä.

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. Kun tunti on kulunut

Kutsu vastaa tilakoodilla 401. Suorita vaihe 3 uudelleen. Jos vaihe 3 nyt epäonnistuu, asiakas tai sen salaisuus on muuttunut Integraatiot-sivulla. Ohjelma noudattaa Todennus-oppaan sääntöä: vaihda uudelleen kerran kutakin 401-vastausta kohden ja lopeta, jos vaihto epäonnistuu.

Jos käännös ja englanninkielinen viite poikkeavat toisistaan, englanninkielinen viite on oikea.