د OAuth پېرودونکی څنګه جوړ کړئ

د API نسخه 2026-10-affable-towhee

مخکې له دې چې د یوځای کېدنو په پاڼه کې «پېرودونکی جوړ کړئ» کېکاږئ، درې شیان وټاکئ: پېرودونکی څه کولی شي، کومه پروسه یې راز ساتي، او د هغه د غوښتنو لګښت څوک ورکوي. د هویت تایید لارښود قاعدې بیانوي؛ دا پاڼه یې په دوو خیالي شرکتونو، Luba او Farducks، پلي کوي.

Luba: Dive Deck

Luba خودکاره سبمرینونه د ترانسپورت او ګډ سفر د خدمت په توګه چلوي. د هغه Dive Deck د کابین په پرده هر مسافر ته د همدې ډوبېدو یوه جمله ښیي، په هغه ژبه چې زده کوي یې، او د Luba د عملیاتو ټیم څاري چې له ونډې څومره پاتې ده.

Luba یو پېرودونکی جوړوي، Luba Dive Deck، چې «لغتونه جوړ کړئ» (vocab:generate) او «کارونه ولولئ» (usage:read) ته اجازه لري، او بیل یې پر «ستاسو د پلان ونډه» (allowance) کېږي. دوه پروسې یې شریکوي، او هره یوه د بدلونې پر مهال یوازې هغه ساحه غواړي چې ورته اړتیا لري. هغه بدلونه چې scope پکې نه وي ټولې هغه ساحې ترلاسه کوي چې پېرودونکي ته اجازه ورکړل شوې؛ هغه چې داسې ساحه وغواړي چې پېرودونکي ته اجازه نه ده ورکړل شوې په بشپړه توګه د invalid_scope سره ردېږي، او هېڅکله په چوپه خوله نه محدودېږي.

د لېږد سرور د هر ډوبېدو جملې لیکي. یوازې vocab:generate غواړي، نو هغه ټوکن چې ترې ووځي د Luba کارونه نشي لوستلی.

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)')"

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

د عملیاتو ډشبورډ د سرور په خوا دویمه پروسه ده چې همغه د پېرودونکي پېژند او راز لري. یوازې usage:read غواړي، او لولي چې له ونډې څه پاتې دي.

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=usage:read" | jq -r '.access_token // error(.error)')"

curl "https://api.getlingara.com/v1/usage" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

دواړه پروسې د Luba په سرورونو چلېږي. په کابین کې ټابلیټ جملې د لېږد له سرور غواړي او هېڅکله راز یا ټوکن نه ساتي، ځکه هر څه چې په داسې وسیله وي چې مسافر یې لمس کولی شي لوستل کېدای شي. د هویت تایید په لارښود کې «رازونه او ټوکنونه په سرور کې وساتئ» برخه یې لامل بیانوي.

همدا پیرودونکی د یوې پروژې په توګه چې کلون یې کولی او چلولی شئ: integrations/luba-dive-deck

Farducks: Batter Rewards

Farducks د کب او کچالو د وړو هټیو یوه لړۍ ده. کله چې یو فرمایش تل کېږي، د وفادارۍ اپ Batter Rewards د Farducks له خپل بک‌اینډ څخه د لوست یو لنډ پلان غواړي، بیا یې لولي. اپ او د پیسو ماشینونه د Farducks بک‌اینډ ته غوښتنې کوي، هېڅکله Lingara ته نه، نو هېڅ یو یې راز نه ساتي.

Farducks یو پېرودونکی جوړوي، Farducks Batter Rewards، چې «د لوست پلانونه جوړ کړئ» (lesson_plans:write) او «د لوست پلانونه ولولئ» (lesson_plans:read) ته اجازه لري، او بیل یې پر «ستاسو د پلان ونډه» (allowance) کېږي. نن ورځ دا یوازینۍ د بیل بڼه ده چې پېرودونکی پرې جوړېدای شي، او د پېرودونکي د بیل بڼه د جوړېدو پر مهال ثابتېږي. بله بڼه، metered («د کارونې په اندازه تادیه»)، د هویت تایید په لارښود کې د «د غوښتنې لګښت څوک ورکوي» برخې لاندې بیان شوې.

بک‌اینډ یوازې lesson_plans:write غواړي او پلان جوړوي. ځواب په جریان کې راځي، او د هغه started پېښه د پلان plan_id لري.

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=lesson_plans:write" | jq -r '.access_token // error(.error)')"

curl -N -X POST "https://api.getlingara.com/v1/lesson-plans" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"context":"Ordering food at a night market","source_lang":"en","target_lang":"zh","level":2}'

ID هماغه plan_id ته وټاکئ، بیا lesson_plans:read وغواړئ او پلان ولولئ. یوه بدلونه کولی شي د پېرودونکي څو ساحې وغواړي، په scope کې په تشو ځایونو بېلې؛ دلته هر امر یوه ساحه غواړي، ځکه هر یو له یوې غوښتنې جوړ شوی.

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=lesson_plans:read" | jq -r '.access_token // error(.error)')"

curl "https://api.getlingara.com/v1/lesson-plans/$ID" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

یوه ورځ راز د ملاتړ په یوه ټکټ کې ولګول شي. د یوځای کېدنو په پاڼه کې، Farducks «نوی راز» کېکاږي او بک‌اینډ ته یې ځای پر ځای کوي، انتظار باسي تر هغه چې د زاړه راز «وروستی ځل کارول شوی» نېټه نور بدلون ونه مومي، بیا د زاړه راز پر «لغوه کول» کېکاږي. له هماغې شېبې هر هغه د لاسرسي ټوکن ردېږي چې د زاړه راز په بدلولو ترلاسه شوی و. د هویت تایید په لارښود کې «د راز بدلول» برخه د دوو رازونو پوله بیانوي، او دا چې ولې د پېرودونکي یوازینی راز نشي لغوه کېدای.

همدا پیرودونکی د یوې پروژې په توګه چې کلون یې کولی او چلولی شئ: integrations/farducks-batter-rewards

بیا چېرته لاړ شئ

د هویت تایید لارښود د بدلونې تېروتنې، د ټوکن د پای ته رسېدو پر مهال څه وکړئ، او د بدلولو قاعده بیانوي. د نسخو لارښود هغه نسخه بیانوي چې پېرودونکی ورپورې تړل شوی، او دا چې د یوې غوښتنې لپاره بله نسخه څنګه وټاکئ.

که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.