Ontkoppel 'n speler van hul Lingara-rekening

API-weergawe 2026-10-virile-dragon

delete https://api.getlingara.com/v1/embed/players/{player_ref}/link

Beëindig 'n speler se koppeling. Die speler speel van die volgende oproep af weer as jou gas. Niks skuif terug nie: wat die koppeling oorgedra het, bly in die leerder se rekening. 'n Speler sonder 'n lewendige koppeling, of een wat reeds ontkoppel is, antwoord 404 embed_link_not_found.

Omvange embed:mint

Parameters

Lingara-Versionheaderstringopsioneel: Die API-weergawe waaronder hierdie versoek beantwoord word. Daarsonder kry 'n toegangstoken die weergawe waaraan sy kliënt gekoppel is, en 'n versoek sonder 'n token kry die huidige weergawe. Die weergawe wat nog ontwikkel word, is slegs bereikbaar deur dit hier te noem. 'n Onbekende weergawe gee 400 met kode api_version_unknown. GET /v1/versions lys die weergawes.
player_refpathstringverplig: Die player_ref waarmee jy die speler se tokens uitgereik het, persent-geënkodeer: guild/42 is guild%2F42.

Antwoorde

204 Die koppeling het geëindig

Foute

410application/json: Die API-weergawe waaronder hierdie versoek beantwoord word, is gestaak. Stuur 'n ondersteunde weergawe in Lingara-Version, of koppel die kliënt aan 'n ander weergawe.
4XXapplication/json: Die versoek is geweier. code sê hoekom, en error sê dit in woorde.
503application/json · text/plain: Die diens is tydelik onbeskikbaar; probeer weer na die aantal sekondes in Retry-After. Tydens onderhoud is die liggaam gewone teks eerder as die foutomhulsel.
5XXapplication/json: Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

codestringverplig: Waarom die versoek geweier is, as 'n stabiele kode om op te vertak: byvoorbeeld insufficient_scope (403), rate_limited (429) en, vir 'n gemeterde kliënt, spend_cap_reached (402) en metered_billing_inactive (402).
errorstringverplig

Voorbeeld

curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

Verkies jy 'n biblioteek? Sien die Biblioteke-afdeling.

Indien 'n vertaling en die Engelse verwysing verskil, is die Engelse verwysing korrek.