إلغاء ربط لاعب بحسابه على 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"

تفضّل مكتبة؟ راجع قسم المكتبات.

إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.