Jinsi ya kuunda mteja wa OAuth

Toleo la API 2026-10-affable-towhee

Kabla ya kubofya “Unda mteja” kwenye ukurasa wa Miunganisho, amua mambo matatu: mteja anaweza kufanya nini, mchakato upi unashikilia siri yake, na nani analipia maombi yake. Mwongozo wa Uthibitishaji unaeleza kanuni; ukurasa huu unazitumia kwa kampuni mbili za kubuni, Luba na Farducks.

Luba: Dive Deck

Luba huendesha nyambizi zinazojiendesha zenyewe kama huduma ya usafiri na ya kusafiri pamoja. Dive Deck yake humwonyesha kila abiria kifungu cha maneno cha safari ya mbizi kwenye skrini ya chumba cha abiria, katika lugha anayojifunza, na timu ya uendeshaji ya Luba hufuatilia kiasi kilichobaki cha kiwango cha matumizi.

Luba huunda mteja mmoja, Luba Dive Deck, anayeruhusiwa “Tengeneza msamiati” (vocab:generate) na “Soma matumizi” (usage:read), na anayetozwa kupitia “Kiasi kilichojumuishwa kwenye mpango wako” (allowance). Michakato miwili inamtumia kwa pamoja, na kila mmoja huomba wakati wa ubadilishaji wigo anaouhitaji tu. Ubadilishaji usio na scope hupata kila wigo anaoruhusiwa mteja; ule unaoomba wigo ambao mteja haruhusiwi hukataliwa wote kwa invalid_scope, na kamwe haupunguzwi kimyakimya.

Seva ya utumaji huandika vifungu vya maneno vya kila safari ya mbizi. Huomba vocab:generate pekee, kwa hivyo tokeni ikivuja kutoka kwake haiwezi kusoma matumizi ya 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}'

Dashibodi ya uendeshaji ni mchakato wa pili wa upande wa seva wenye kitambulisho cha mteja na siri zilezile. Huomba usage:read pekee, na husoma kilichobaki cha kiwango cha matumizi.

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"

Michakato yote miwili huendeshwa kwenye seva za Luba. Kompyuta kibao iliyo kwenye chumba cha abiria huiomba seva ya utumaji vifungu vya maneno na kamwe haishikilii siri wala tokeni, kwa sababu chochote kilicho kwenye kifaa ambacho abiria anaweza kukigusa kinaweza kusomwa. Sehemu ya Weka siri na tokeni kwenye seva katika mwongozo wa Uthibitishaji inaeleza sababu.

Mteja huyo huyo kama mradi unaoweza kuunakili na kuuendesha: integrations/luba-dive-deck

Farducks: Batter Rewards

Farducks ni msururu wa maduka ya urahisi ya samaki na chipsi. Wakati oda inakaangwa, programu ya uaminifu ya Batter Rewards huiomba seva ya nyuma ya Farducks yenyewe mpango mfupi wa somo, kisha huusoma tena. Programu na mashine za malipo huita seva ya nyuma ya Farducks, kamwe si Lingara, kwa hivyo hakuna kati yao inayoshikilia siri.

Farducks huunda mteja mmoja, Farducks Batter Rewards, anayeruhusiwa “Unda mipango ya masomo” (lesson_plans:write) na “Soma mipango ya masomo” (lesson_plans:read), na anayetozwa kupitia “Kiasi kilichojumuishwa kwenye mpango wako” (allowance). Hiyo ndiyo njia pekee ya utozaji ambayo mteja anaweza kuundwa nayo leo, na njia ya utozaji ya mteja huwekwa kabisa anapoundwa. Njia nyingine, metered (“Lipa kulingana na matumizi”), imeelezwa chini ya Nani analipia ombi katika mwongozo wa Uthibitishaji.

Seva ya nyuma huomba lesson_plans:write pekee na huunda mpango. Jibu hutiririshwa, na tukio lake la started hubeba plan_id ya mpango.

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

Weka ID kuwa plan_id hiyo, kisha omba lesson_plans:read na usome mpango tena. Ubadilishaji mmoja unaweza kuomba wigo kadhaa wa mteja, ukitenganishwa kwa nafasi katika scope; kila amri hapa huomba mmoja, kwa sababu kila moja imeundwa kutokana na ombi moja.

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"

Siku moja siri inabandikwa kwenye tiketi ya usaidizi. Kwenye ukurasa wa Miunganisho, Farducks hubofya “Siri mpya” na kuisambaza kwenye seva ya nyuma, husubiri hadi tarehe ya “Ilitumika mwisho” ya siri ya zamani iache kubadilika, kisha hubofya “Batilisha” kwenye siri ya zamani. Kuanzia wakati huo, kila tokeni ya ufikiaji iliyopatikana kwa kubadilisha siri ya zamani hukataliwa. Zungusha siri, katika mwongozo wa Uthibitishaji, inaeleza kikomo cha siri mbili na kwa nini siri pekee ya mteja haiwezi kubatilishwa.

Mteja huyo huyo kama mradi unaoweza kuunakili na kuuendesha: integrations/farducks-batter-rewards

Hatua zinazofuata

Mwongozo wa Uthibitishaji unaeleza hitilafu za ubadilishaji, cha kufanya tokeni inapoisha muda, na kanuni ya kuzungusha siri. Mwongozo wa Matoleo unaeleza toleo ambalo mteja amefungwa kwake, na jinsi ya kuchagua jingine kwa ombi moja.

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