खिलाड़ी के लिए टोकन जारी करें

पैरामीटर

Lingara-Versionheaderstringवैकल्पिक

वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर 400 और कोड api_version_unknown होता है। GET /v1/versions संस्करणों की सूची देता है।

अनुरोध बॉडी application/json

player_refstringआवश्यक

खिलाड़ी के लिए आपका अपना संदर्भ: बिना नियंत्रण वर्णों के 1 से 128 बाइट का UTF-8। Lingara केवल उसका हैश सहेजता है।

scopesarray of string | nullवैकल्पिक

originstring | nullवैकल्पिक

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

200 खिलाड़ी का टोकन

tokenstringआवश्यक

expires_atstringआवश्यक

expires_inintegerआवश्यक

इस जवाब से गिनकर टोकन की अवधि खत्म होने तक के सेकंड। जब डिवाइस की घड़ी पर भरोसा न हो, तब इसका इस्तेमाल करें।

subjectstringआवश्यक

scopesarray of stringआवश्यक

account_linkedbooleanआवश्यक

त्रुटियाँ

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 POST "https://api.getlingara.com/v1/embed/tokens" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"player_ref":"player-1001","scopes":["embed:play","lesson_plans:read","lesson_plans:write"],"origin":"https://game.example.com"}'

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