Kuanza haraka

Toleo la API 2026-10-affable-towhee

Hatua tano kutoka mwanzo hadi orodha ya msamiati inayotiririshwa: unda mteja, weka taarifa zake kwenye shell yako, zibadilishe kwa tokeni ya ufikiaji, tuma ombi moja, na upate tokeni mpya muda wake unapoisha.

1. Unda mteja

Kwenye ukurasa wa Miunganisho wa programu ya wavuti ya Lingara, katika app.getlingara.com/admin, chini ya Wateja wa OAuth, unda mteja mwenye uwezo wa Tengeneza msamiati (wigo vocab:generate). Nakili kitambulisho cha mteja na siri yake. Siri huonyeshwa mara moja tu.

2. Ziweke kwenye shell yako

Hifadhi kitambulisho cha mteja na siri katika vigezo vya mazingira LINGARA_CLIENT_ID na LINGARA_CLIENT_SECRET, ili siri isiandikwe kamwe ndani ya amri.

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

3. Pata tokeni ya ufikiaji

Amri hii hubadilisha mteja kwa tokeni ya ufikiaji na kuihifadhi katika LINGARA_TOKEN, ambayo kila mfano katika marejeleo haya huisoma. Inahitaji jq na curl 7.76 au toleo jipya zaidi. Ubadilishaji ukishindwa, amri huchapisha msimbo wa hitilafu (kwa mfano invalid_client: kagua kitambulisho na siri) na huacha LINGARA_TOKEN tupu, kwa hivyo ombi linalofuata hushindwa kwa 401 hadi ubadilishaji ufaulu. Bila jq, endesha ubadilishaji kutoka kwenye mwongozo wa Uthibitishaji na unakili access_token kutoka kwenye jibu kwa mkono.

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. Tengeneza orodha ya msamiati

Endesha amri hii. -N huzima uhifadhi wa muda (buffering) wa curl, ili kila tukio lichapishwe mara tu linapofika.

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

Unachopaswa kuona

Tukio la started pamoja na maelezo ya orodha, tukio moja la item kwa kila neno, kisha done. Maneno yako yatatofautiana na mfano huu.

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. Saa moja ikiisha

Ombi hujibu 401. Endesha hatua ya 3 tena. Ikiwa sasa hatua ya 3 inashindwa, mteja au siri yake imebadilika kwenye ukurasa wa Miunganisho. Programu hufuata kanuni ya mwongozo wa Uthibitishaji: badilisha tena mara moja kwa kila 401, na uache ikiwa ubadilishaji utashindwa.

Ikiwa tafsiri na marejeleo ya Kiingereza yanatofautiana, marejeleo ya Kiingereza ndiyo sahihi.