Lingara Lingara مستندات راهنماها API کتابخانه‌ها برنامه‌ها ساخت جاسازی نسخهٔ وب
زبان: فارسی

حذف بازیکن

نسخهٔ 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"

کتابخانه را ترجیح می‌دهید؟ بخش کتابخانه‌ها را ببینید.

اگر ترجمه با مرجع انگلیسی تفاوت داشته باشد، مرجع انگلیسی معتبر است.