Destpêka bilez

Guhertoya API 2026-10-affable-towhee

Pênc gav ji tunebûnê heta lîsteyeke peyvan a streamkirî: klientekî çêke, wî têxe shella xwe, wî bi tokeneke gihîştinê biguherîne, bangekê bike, û dema ku token diqede tokeneke nû bistîne.

1. Klientekî çêke

Li rûpela Entegrasyon a sepana webê ya Lingara, li app.getlingara.com/admin, di bin Klientên OAuth de, klientekî çêke ku destûra wî ya Peyvan çêke hebe (scopeya vocab:generate). Nasnameya klient û nepeniya wî kopî bike. Nepenî tenê carekê tê nîşandan.

2. Wî têxe shella xwe

Nasnameya klient û nepeniyê di guhêrbarên jîngehê LINGARA_CLIENT_ID û LINGARA_CLIENT_SECRET de tomar bike, da ku tu nepenî tu carî di fermanekê de neyê nivîsandin.

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

3. Tokeneke gihîştinê bistîne

Ev ferman klient bi tokeneke gihîştinê diguherîne û wê di LINGARA_TOKEN de digire, ku her mînakek di vê referansê de wê dixwîne. Ew jq û curl 7.76 an nûtir hewce dike. Ger guhertin têk biçe, ferman koda çewtiyê çap dike (bo nimûne invalid_client: nasname û nepeniyê kontrol bike) û LINGARA_TOKEN vala dihêle, ji ber vê yekê banga din bi 401 têk diçe heta ku guhertinek biserkeve. Bê jq, guhertinê ji rêbera Rastandin bixebitîne û access_token ji bersivê bi destan kopî bike.

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. Lîsteyeke peyvan çêbike

Vê fermanê bixebitîne. -N bufferkirina curl digire, da ku her bûyer hema ku bigihîje were çapkirin.

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

Divê tu çi bibînî

Bûyereke started bi hûrguliyên lîsteyê, ji bo her peyvê bûyereke item, paşê done. Peyvên te dê ji vê mînakê cuda bin.

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. Dema ku saet diqede

Bang 401 bersiv dide. Gava 3 dîsa bixebitîne. Ger gava 3 êdî têk diçe, klient an nepeniya wî li rûpela Entegrasyon hatiye guhertin. Bernameyek qaîdeya rêbera Rastandin dişopîne: ji bo her 401 carekê dîsa biguherîne, û ger guhertin têk biçe raweste.

Ger wergerek û referansa Îngilîzî ji hev cuda bin, referansa Îngilîzî rast e.