Een speler verwijderen
API-versie 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}
Verwijdert een van je spelers en alles wat die heeft gemaakt: plannen, gebeurtenissen en geldige tokens. Veilig om opnieuw te proberen: een onbekende player_ref antwoordt ook met 204.
Bevoegdheden embed:mint
Parameters
Lingara-Versionheaderstringoptioneel- De API-versie waaronder dit verzoek wordt beantwoord. Zonder deze krijgt een toegangstoken de versie waaraan zijn client is gekoppeld, en een verzoek zonder token de huidige versie. De versie die nog in ontwikkeling is, bereik je alleen door die hier te noemen. Een onbekende versie geeft
400met codeapi_version_unknown.GET /v1/versionstoont de versies. player_refpathstringverplicht- De
player_refwaarmee je de tokens van de speler hebt uitgegeven, procentgecodeerd:guild/42wordtguild%2F42.
Antwoorden
204 De speler is verwijderd
Fouten
410application/json- De API-versie waaronder dit verzoek wordt beantwoord, is stopgezet. Stuur een ondersteunde versie mee in
Lingara-Version, of koppel de client aan een andere versie. 4XXapplication/json- Het verzoek is geweigerd.
codegeeft de reden aan enerrorbeschrijft die in woorden. 503application/json · text/plain- De dienst is tijdelijk niet beschikbaar; probeer het opnieuw na het aantal seconden in
Retry-After. Tijdens onderhoud is de body platte tekst in plaats van de foutenvelop. 5XXapplication/json- Het verzoek is geweigerd.
codegeeft de reden aan enerrorbeschrijft die in woorden.
codestringverplichtWaarom het verzoek is geweigerd, als stabiele code om op te vertakken: bijvoorbeeld
insufficient_scope(403),rate_limited(429) en, voor een client met verbruiksafrekening,spend_cap_reached(402) enmetered_billing_inactive(402).errorstringverplicht
Voorbeeld
curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF" \
-H "Authorization: Bearer $LINGARA_TOKEN"Als een vertaling afwijkt van de Engelse referentie, is de Engelse referentie juist.