قطع وصل بازیکن از حساب Lingara او
نسخهٔ API 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}/link
وصل یک بازیکن را پایان می‌دهد. بازیکن از فراخوانی بعدی دوباره به‌حیث مهمان شما بازی می‌کند. چیزی دوباره برنمی‌گردد: آنچه وصل انتقال داده در حساب آموزنده می‌ماند. بازیکنی که وصل فعال ندارد، یا وصلش قبلاً قطع شده، پاسخ 404 embed_link_not_found می‌دهد.
حوزه‌های دسترسی 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/link" \
-H "Authorization: Bearer $LINGARA_TOKEN"اگر ترجمه با مرجع انگلیسی فرق داشته باشد، مرجع انگلیسی درست است.