खिलाड़ी हटाएँ
API संस्करण 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}
आपके किसी खिलाड़ी को और उसकी बनाई हर चीज़ को हटाता है: उसकी योजनाएँ, उसके इवेंट और उसके मान्य टोकन। दोबारा कोशिश करना सुरक्षित है: अनजान player_ref भी 204 का जवाब देता है।
स्कोप embed:mint
पैरामीटर
Lingara-Versionheaderstringवैकल्पिक- वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर
400और कोडapi_version_unknownहोता है।GET /v1/versionsसंस्करणों की सूची देता है। player_refpathstringआवश्यक- वह
player_refजिससे आपने खिलाड़ी के टोकन जारी किए थे, प्रतिशत-एन्कोड किया हुआ:guild/42बनता हैguild%2F42।
प्रतिक्रियाएँ
204 खिलाड़ी हटा दिया गया
त्रुटियाँ
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 DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF" \
-H "Authorization: Bearer $LINGARA_TOKEN"यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।