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