لغو پیوند بازیکن از حساب 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"اگر ترجمه با مرجع انگلیسی تفاوت داشته باشد، مرجع انگلیسی معتبر است.