त्वरित शुरुआत

API संस्करण 2026-10-affable-towhee

शून्य से स्ट्रीम की गई शब्दावली सूची तक पाँच चरण: एक क्लाइंट बनाएँ, उसे अपने शेल में रखें, उसे एक्सेस टोकन के बदले एक्सचेंज करें, एक कॉल करें, और टोकन की अवधि समाप्त होने पर नया टोकन लें।

1. क्लाइंट बनाएँ

Lingara वेब ऐप के इंटीग्रेशन पेज पर, app.getlingara.com/admin पर, OAuth क्लाइंट के अंतर्गत, ऐसा क्लाइंट बनाएँ जिसे “शब्दावली बनाएँ” की अनुमति हो (स्कोप vocab:generate)। उसकी क्लाइंट ID और उसका सीक्रेट कॉपी करें। सीक्रेट केवल एक बार दिखाया जाता है।

2. इसे अपने शेल में रखें

क्लाइंट ID और सीक्रेट को LINGARA_CLIENT_ID और LINGARA_CLIENT_SECRET एनवायरनमेंट वेरिएबल में संग्रहीत करें, ताकि कोई सीक्रेट कभी किसी कमांड में न लिखा जाए।

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

3. एक्सेस टोकन पाएँ

यह कमांड क्लाइंट को एक्सेस टोकन के बदले एक्सचेंज करती है और उसे LINGARA_TOKEN में रखती है, जिसे इस संदर्भ का हर उदाहरण पढ़ता है। इसके लिए jq और curl 7.76 या उसके बाद का संस्करण चाहिए। यदि एक्सचेंज विफल होता है, तो कमांड त्रुटि कोड प्रिंट करती है (उदाहरण के लिए invalid_client: ID और सीक्रेट जाँचें) और LINGARA_TOKEN को खाली छोड़ देती है, इसलिए अगली कॉल तब तक 401 के साथ विफल होती है जब तक कोई एक्सचेंज सफल न हो। jq के बिना, प्रमाणीकरण गाइड से एक्सचेंज चलाएँ और जवाब से access_token हाथ से कॉपी करें।

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. शब्दावली सूची बनाएँ

यह कमांड चलाएँ। -N curl की बफ़रिंग बंद करता है, ताकि हर इवेंट आते ही प्रिंट हो।

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

आपको क्या दिखना चाहिए

सूची के विवरण के साथ एक started इवेंट, हर शब्द के लिए एक item इवेंट, फिर done। आपके शब्द इस उदाहरण से अलग होंगे।

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. जब एक घंटा पूरा हो जाए

कॉल 401 लौटाती है। चरण 3 फिर से चलाएँ। यदि अब चरण 3 विफल होता है, तो इंटीग्रेशन पेज पर क्लाइंट या उसका सीक्रेट बदल गया है। कोई प्रोग्राम प्रमाणीकरण गाइड के नियम का पालन करता है: हर 401 पर एक बार फिर से एक्सचेंज करें, और एक्सचेंज विफल हो तो रुक जाएँ।

यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।