Nyahpautkan pemain daripada akaun Lingara mereka
Versi API 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}/link
Menamatkan pautan pemain. Mulai panggilan seterusnya pemain bermain semula sebagai tetamu anda. Tiada apa yang dikembalikan: apa yang dipindahkan oleh pautan kekal dalam akaun pelajar. Pemain tanpa pautan aktif, atau yang sudah dinyahpaut, menjawab 404 embed_link_not_found.
Skop embed:mint
Parameter
Lingara-Versionheaderstringpilihan- Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapat versi yang dipautkan kepada kliennya, dan permintaan tanpa token mendapat versi semasa. Versi yang masih dalam pembangunan hanya boleh dicapai dengan menamakannya di sini. Versi yang tidak dikenali dijawab
400dengan kodapi_version_unknown.GET /v1/versionsmenyenaraikan versi. player_refpathstringwajibplayer_refyang anda gunakan untuk mengeluarkan token pemain, dikodkan peratus:guild/42ialahguild%2F42.
Respons
204 Pautan telah tamat
Ralat
410application/json- Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Hantar versi yang disokong dalam
Lingara-Version, atau pautkan klien kepada versi lain. 4XXapplication/json- Permintaan ditolak.
codemenyatakan sebabnya, danerrormenerangkannya dengan perkataan. 503application/json · text/plain- Perkhidmatan tidak tersedia buat sementara waktu; cuba lagi selepas bilangan saat dalam
Retry-After. Semasa penyelenggaraan, kandungan ialah teks biasa dan bukan sampul ralat. 5XXapplication/json- Permintaan ditolak.
codemenyatakan sebabnya, danerrormenerangkannya dengan perkataan.
codestringwajibSebab permintaan ditolak, sebagai kod stabil untuk dijadikan asas percabangan: contohnya
insufficient_scope(403),rate_limited(429) dan, bagi klien bermeter,spend_cap_reached(402) danmetered_billing_inactive(402).errorstringwajib
Contoh
curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
-H "Authorization: Bearer $LINGARA_TOKEN"Jika terjemahan dan rujukan bahasa Inggeris berbeza, rujukan bahasa Inggeris adalah yang betul.