किसी खिलाड़ी को उसके Lingara खाते से लिंक करें

API संस्करण 2026-10-virile-dragon

put https://api.getlingara.com/v1/embed/players/{player_ref}/link

आपके किसी खिलाड़ी को उस Lingara खाते से लिंक करता है जिसने अभी-अभी आपके ऐप को पहुँच दी है। इसे उस प्रत्यायोजित टोकन से कॉल करें जो आपके सर्वर को उस खाते के लिए मिला है, कभी भी अपने क्लाइंट के अपने टोकन से नहीं। उसके बाद से खिलाड़ी के टोकन उस खाते के रूप में काम करते हैं, जितना अनुमति देती है: events:read माँगें, वरना लिंक के बाद आपको खिलाड़ी के बारे में कुछ पता नहीं चलेगा। पूरे हो चुके प्लान खाते में चले जाते हैं; जो प्लान अभी लिखा जा रहा है वह तब तक रहता है जब तक आप दोबारा कॉल नहीं करते। दोहराना सुरक्षित है: दोहराने पर existing उत्तर मिलता है और वह चला जाता है जो पहले नहीं जा सका था। लिंक करने का आपसे कोई शुल्क नहीं लगता।

स्कोप embed:play

पैरामीटर

Lingara-Versionheaderstringवैकल्पिक: वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर 400 और कोड api_version_unknown होता है। GET /v1/versions संस्करणों की सूची देता है।
player_refpathstringआवश्यक: वह player_ref जिससे आपने खिलाड़ी के टोकन जारी किए थे, प्रतिशत-एन्कोड किया हुआ: guild/42 बनता है guild%2F42।

प्रतिक्रियाएँ

200 खिलाड़ी का लिंक

statusLinkStatusआवश्यक
subjectstringआवश्यक: खाते का lgr_sub_: अब से इस खिलाड़ी के इवेंट जो साथ रखते हैं।
previous_subjectstringआवश्यक: अतिथि का lgr_sub_: खिलाड़ी के पहले के इवेंट जो बनाए रखते हैं। दोनों को एक ही player_ref पर भेजें।
linked_atstringआवश्यक: लिंक कब बना। existing उत्तर में, पहली कॉल का समय।
scopesarray of stringआवश्यक: इस खिलाड़ी का टोकन अब अधिकतम जो रख सकता है: खाते ने जो अनुमति दी, उन स्कोप में से जो किसी खिलाड़ी का टोकन रख सकता है।
carriedobjectआवश्यक: इस कॉल ने खाते में जो पंक्तियाँ भेजीं, हर तालिका के अनुसार। केवल गिनती वाली तालिकाएँ दिखती हैं।
keptobjectआवश्यक: इस कॉल ने अतिथि के पास जो पंक्तियाँ छोड़ीं, हर तालिका के अनुसार: अभी लिखा जा रहा प्लान, या ऐसी पंक्ति जो खाते में पहले से थी। जब यहाँ lesson_plans में कोई पूरा हुआ प्लान हो, तब दोबारा कॉल करें।

त्रुटियाँ

402application/json: मीटर्ड क्लाइंट की कॉल कुछ भी खर्च होने से पहले ही अस्वीकार कर दी गई। spend_cap_reached: क्लाइंट या उसका खाता अपनी मासिक खर्च सीमा तक पहुँच गया है; इंटीग्रेशन पेज पर सीमा बढ़ाएँ। metered_billing_inactive: इस खाते के लिए उपयोग-आधारित बिलिंग सक्रिय नहीं है; इंटीग्रेशन पेज पर इसे सेट अप करें या भुगतान का तरीका अपडेट करें।
410application/json: जिस API संस्करण के अंतर्गत इस अनुरोध का उत्तर दिया जाता है, वह बंद कर दिया गया है। Lingara-Version में कोई समर्थित संस्करण भेजें, या क्लाइंट को किसी दूसरे संस्करण से जोड़ें।
4XXapplication/json: अनुरोध अस्वीकार कर दिया गया। code कारण बताता है, और error उसे शब्दों में बताता है।
503application/json · text/plain: सेवा अस्थायी रूप से अनुपलब्ध है; Retry-After में दिए गए सेकंड के बाद पुनः प्रयास करें। रखरखाव के दौरान बॉडी त्रुटि लिफ़ाफ़े के बजाय सादा टेक्स्ट होती है।
5XXapplication/json: अनुरोध अस्वीकार कर दिया गया। code कारण बताता है, और error उसे शब्दों में बताता है।

codestringआवश्यक: अनुरोध क्यों अस्वीकार किया गया, एक स्थिर कोड के रूप में जिसके आधार पर आप शाखा बना सकते हैं: उदाहरण के लिए insufficient_scope (403), rate_limited (429) और, मीटर्ड क्लाइंट के लिए, spend_cap_reached (402) और metered_billing_inactive (402)।
errorstringआवश्यक

उदाहरण

curl -X PUT "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

लाइब्रेरी पसंद है? लाइब्रेरी अनुभाग देखें।

यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।