د Lingara ځای پر ځای کول

دا پاڼه له انګلیسي ژبې ژباړل شوې ده. که دواړه سره توپیر ولري، انګلیسي پاڼه سمه ده. انګلیسي پاڼه ولولئ

Lingara کولی شي ستاسو د لوبې یا وېبپاڼې دننه ژوند وکړي. ستاسو په نړۍ کې یو کرکټر کولی شي د لوبغاړي په کچه خبرې اترې وکړي، او هغه تمرین چې ستاسو لوبغاړی یې بشپړوي د Lingara د تمرین په توګه حسابېږي. ځای پر ځای کول دوه نیمې لري، او لومړی شی چې باید روښانه شي دا دی چې کومه نیمه چېرته چلېږي.

څوک څه ساتي

ستاسو سرور ستاسو د OAuth کلاینټ راز او ستاسو د ویب‌هوک د لاسلیک راز ساتي. هېڅ یو یې هېڅکله له هغه نه وځي.

د لوبغاړي وسیله یو شی ساتي: د ځای پر ځای کولو یو ټوکن، چې په lgr_et_ پیلېږي. هر هغه څه چې تاسو یې د لوبې په باینري یا وېبپاڼه کې لېږدوئ عامه دي، نو وسیله هېڅکله د کلاینټ راز، د ویب‌هوک راز یا ستاسو د خپل کلاینټ د لاسرسي ټوکن نه ساتي. د ځای پر ځای کولو ټوکن یوازې د یوه لوبغاړي لپاره کار کوي، د ساعتونو پر ځای دقیقې دوام کوي، او یوازې هغه سکوپونه لري چې ستاسو سرور ورته ورکړي دي.

لوبغاړی د Lingara حساب ته اړتیا نه لري. لومړی ټوکن چې ستاسو سرور یې د یوه لوبغاړي لپاره جوړوي د هغه لپاره یو مېلمه زده کوونکی جوړوي، او هر وروستی ټوکن همغه زده کوونکي ته رسي. هغه لوبغاړی چې دمخه د Lingara حساب لري کولی شي هغه راوړي: د سرور کیټونو پاڼه تشریح کوي چې ستاسو سرور دا دواړه څنګه سره تړي.

ټوکن څنګه لوبغاړي ته رسي

1. د لوبغاړي کیټ، ستاسو په لوبه کې یا ستاسو په پاڼه کې، ټوکن ته اړتیا لري او د خپلې ټوکن سرچینې له لارې یې له ستاسو سرور څخه غواړي.
2. ستاسو سرور د هغه لوبغاړي لپاره خپله ناسته چیک کوي او د سرور کیټ په مرسته د هغه لپاره یو ټوکن جوړوي.
3. ستاسو سرور ټوکن د دوو برخو په توګه بېرته ورکوي، ټوکن او د هغه د پای ته رسېدو وخت، د خپلې ناستې له لارې او هېڅکله په URL کې نه.
4. د لوبغاړي کیټ ټوکن تر هغه کاروي چې د پای ته رسېدو وخت ته نږدې شي، بیا بیا له ستاسو سرور څخه غوښتنه کوي. Lingara هېڅکله ټوکن نه تازه کوي.

 player's device                your server                    Lingara
 ───────────────                ───────────                    ───────
 player kit ── needs a token ──▶ your token route
                                 server kit ── mint ─────────▶ token for one player
 player kit ◀── token, expiry ── your token route ◀──────────
 player kit ── API calls with the token ─────────────────────▶

د وېبپاڼې ټوکن په یوه origin پورې تړلی دی: د پاڼې خپل scheme، host او port. هر هغه origin چې ستاسو ویجټ پرې چلېږي د هغه لپاره د ټوکن جوړولو مخکې ثبت کړئ، لکه څنګه چې د سرور کیټونو پاڼه تشریح کوي. د لوبې ټوکن هېڅ origin نه لري.

ټوکن څه کولی شي

ستاسو سرور د هر ټوکن سکوپونه د جوړولو پر مهال ټاکي، له دې پنځو څخه: events:read، events:write، lesson_plans:read، lesson_plans:write او embed:play. یو ټوکن یوازې هغه سکوپونه لرلی شي چې ستاسو خپل کلاینټ یې دمخه لري. embed:play لوبغاړي ته اجازه ورکوي چې ستاسو له کرکټرونو سره خبرې اترې وکړي او هغه تمرین راپور کړي چې بشپړوي یې.

څوک پیسې ورکوي

یوازې هغه کلاینټ چې په مېټر شوي پلان کې وي کولی شي ټوکنونه جوړ کړي. هر هغه څه چې لوبغاړی یې د ټوکن سره کوي ستاسو د کلاینټ د کارونې په توګه حسابېږي او پیسې یې له تاسو اخیستل کېږي، نه له لوبغاړي.

د لوبغاړي ړنګول

کله چې یو لوبغاړی په ستاسو لوبه کې خپل حساب ړنګ کړي، ستاسو سرور هغه په Lingara کې هم ړنګوي. دا د هغه زده کوونکی او هر هغه څه چې Lingara یې د هغه لپاره ساتي لرې کوي، او هر هغه ټوکن چې هغه یې لري لغوه کوي.

تاسو کوم کیټ ته اړتیا لرئ

هر ادغام دوه کیټونه کاروي: یو سرور کیټ ستاسو په سرور کې، او د لوبغاړي یو کیټ هلته چې لوبغاړی لوبه کوي.

بیا د NPC خبرې اترې او د تمرین پایلې ولولئ، چې په هر کیټ کې په یوه ډول کار کوي.