چۆن کلاینتێکی 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

دواتر بۆ کوێ بچیت

ڕێبەری پشتڕاستکردنەوەی ناسنامە هەڵەکانی گۆڕینەوە، ئەوەی کاتێک تۆکنێک بەسەر دەچێت چی بکەیت، و یاسای گۆڕینی نهێنی دەگرێتەوە. ڕێبەری وەشانەکان ئەو وەشانە دەگرێتەوە کە کلاینتێک پێیەوە بەستراوە، و چۆن وەشانێکی تر بۆ یەک بانگکردن هەڵبژێریت.

ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.