Mabilisang pagsisimula

Bersyon ng API 2026-10-affable-towhee

Limang hakbang mula sa wala hanggang sa na-stream na listahan ng bokabularyo: gumawa ng client, ilagay ito sa iyong shell, ipalit ito sa isang access token, gumawa ng isang tawag, at kumuha ng bagong token kapag nag-expire ito.

1. Gumawa ng client

Sa pahinang Mga integration ng Lingara web app, sa app.getlingara.com/admin, sa ilalim ng Mga OAuth client, gumawa ng client na may pahintulot na Gumawa ng bokabularyo (ang scope na vocab:generate). Kopyahin ang ID ng client at ang secret nito. Isang beses lamang ipinapakita ang secret.

2. Ilagay ito sa iyong shell

Itago ang ID ng client at ang secret sa mga environment variable na LINGARA_CLIENT_ID at LINGARA_CLIENT_SECRET, kaya walang secret na isinusulat kailanman sa isang command.

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

3. Kumuha ng access token

Ipinapalit ng command na ito ang client sa isang access token at itinatago ito sa LINGARA_TOKEN, na binabasa ng bawat halimbawa sa sangguniang ito. Kailangan nito ang jq at curl 7.76 o mas bago. Kung mabigo ang pagpapalit, ipi-print ng command ang error code (halimbawa invalid_client: suriin ang ID at secret) at iiwanang walang laman ang LINGARA_TOKEN, kaya mabibigo ang susunod na tawag nang may 401 hanggang magtagumpay ang isang pagpapalit. Kung walang jq, patakbuhin ang pagpapalit mula sa gabay sa Pagpapatunay at kopyahin nang mano-mano ang access_token mula sa response.

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. Gumawa ng listahan ng bokabularyo

Patakbuhin ang command na ito. Pinapatay ng -N ang buffering ng curl, kaya naipi-print ang bawat event sa sandaling dumating ito.

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

Ano ang dapat mong makita

Isang started na event kasama ang mga detalye ng listahan, isang item na event bawat salita, pagkatapos ay done. Iba ang magiging mga salita mo sa halimbawang ito.

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. Kapag lumipas na ang isang oras

Sumasagot ang tawag ng 401. Patakbuhin muli ang hakbang 3. Kung nabigo na ngayon ang hakbang 3, nagbago ang client o ang secret nito sa pahinang Mga integration. Sinusunod ng isang programa ang tuntunin ng gabay sa Pagpapatunay: magpalit muli nang isang beses bawat 401, at huminto kung mabigo ang pagpapalit.

Kung magkaiba ang isang salin at ang sangguniang Ingles, ang sangguniang Ingles ang tama.