Meriv çawa klientekî OAuth çêdike

Guhertoya API 2026-10-affable-towhee

Berî ku tu li rûpela Entegrasyon “Klient çêke” bitikînî, li ser sê tiştan biryar bide: klient dikare çi bike, kîjan pêvajo nepeniya wî digire, û kî heqê bangên wî dide. Rêbera Rastandin qaîdeyan diyar dike; ev rûpel wan li ser du şirketên xeyalî, Luba û Farducks, bi cih tîne.

Luba: Dive Deck

Luba binderyayiyên xweser wek xizmeteke veguhastin û parvekirina rêwîtiyê dixebitîne. Dive Deck a wê li ser ekrana kabînê ji her rêwiyekî re hevokeke ji binavbûnê nîşan dide, bi wî zimanê ku ew fêr dibe, û tîma operasyonan a Luba dişopîne ka çiqas ji mafê bikaranînê maye.

Luba klientekî çêdike, Luba Dive Deck, ku destûra wî ya “Peyvan çêke” (vocab:generate) û “Bikaranînê bixwîne” (usage:read) heye û li ser “Kotaya plana te” (allowance) tê fatûrekirin. Du pêvajo wî parve dikin, û her yek di dema guhertinê de tenê wê scopeyê dixwaze ku hewce dike. Guhertineke ku scope nenivîse her scopeya ku ji klient re destûrdayî ye distîne; guhertineke ku scopeyeke ne destûrdayî dixwaze bi tevahî bi invalid_scope tê redkirin, tu carî bi bêdengî nayê tengkirin.

Servera dîspeçê hevokên her binavbûnê dinivîse. Ew tenê vocab:generate dixwaze, ji ber vê yekê tokeneke ku jê derkeve nikare bikaranîna Luba bixwîne.

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

Dashboarda operasyonan pêvajoyeke duyem a li aliyê serverê ye, bi heman nasnameya klient û nepeniyê. Ew tenê usage:read dixwaze, û dixwîne ka çi ji mafê bikaranînê maye.

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"

Herdu pêvajo li ser serverên Luba dixebitin. Tableta di kabînê de hevokan ji servera dîspeçê dixwaze û tu carî nepenî an tokenekê nagire, ji ber ku her tiştê li ser amûreke ku rêwiyek dikare dest lê bide dikare were xwendin. Beşa “Nepenî û tokenan li ser serverekê bihêle” ya rêbera Rastandin dibêje çima.

Heman client wek projeyek ku tu dikarî klon bikî û bixebitînî: integrations/luba-dive-deck

Farducks: Batter Rewards

Farducks zincîreyeke firoşgehên hêsan ên masî û kartolên sorkirî ye. Dema ku fermanek tê sorkirin, sepana dilsoziyê Batter Rewards planeke dersê ya kurt ji backenda Farducks bi xwe dixwaze, paşê wê dixwîne. Sepan û kase backenda Farducks bang dikin, tu carî Lingara na, ji ber vê yekê tu yek ji wan nepeniyê nagire.

Farducks klientekî çêdike, Farducks Batter Rewards, ku destûra wî ya “Planên dersê çêke” (lesson_plans:write) û “Planên dersê bixwîne” (lesson_plans:read) heye û li ser “Kotaya plana te” (allowance) tê fatûrekirin. Îro klientek tenê bi vê fatûrekirinê dikare were çêkirin, û fatûrekirina klientekî dema çêkirinê tê sabîtkirin. Awayê din, metered (“Li gorî bikaranînê bide”), di beşa “Kî heqê bangekê dide” ya rêbera Rastandin de hatiye ravekirin.

Backend tenê lesson_plans:write dixwaze û planê çêdike. Bersiv tê streamkirin, û bûyera wê ya started plan_id a planê digire.

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 bike ew plan_id, paşê lesson_plans:read bixwaze û planê bixwîne. Guhertinek dikare çend scopeyên klient bixwaze, di scope de bi valahiyan ji hev veqetandî; li vir her ferman tenê yekê dixwaze, ji ber ku her yek ji bangeke tenê pêk tê.

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"

Rojekê nepenî di bilêteke piştgiriyê de tê pêvekirin. Li rûpela Entegrasyon, Farducks “Nepeniya nû” ditikîne û wê li backendê bi cih dike, li bendê dimîne heta ku dîroka “Bikaranîna dawî” ya nepeniya kevn êdî neguhere, paşê li ser nepeniya kevn “Betal bike” ditikîne. Ji wê kêliyê ve, her tokena gihîştinê ya ku bi nepeniya kevn hatiye guhertin tê redkirin. Beşa “Nepeniyekê nû bike” ya rêbera Rastandin sînorê du nepeniyan û sedema ku nepeniya tenê ya klientekî nayê betalkirin rave dike.

Heman client wek projeyek ku tu dikarî klon bikî û bixebitînî: integrations/farducks-batter-rewards

Paşê biçe ku derê

Rêbera Rastandin çewtiyên guhertinê, dema ku token diqede divê çi were kirin, û qaîdeya nûkirinê vedigire. Rêbera Guherto guhertoya ku klient pê ve girêdayî ye, û çawa ji bo bangekê guhertoyeke din were hilbijartin, vedigire.

Ger wergerek û referansa Îngilîzî ji hev cuda bin, referansa Îngilîzî rast e.