Poista pelaajan linkitys hänen Lingara-tiliinsä
API-versio 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}/link
Päättää pelaajan linkityksen. Seuraavasta kutsusta alkaen pelaaja pelaa taas vieraanasi. Mitään ei siirretä takaisin: se, minkä linkitys siirsi, jää oppijan tilille. Pelaaja, jolla ei ole voimassa olevaa linkitystä tai jonka linkitys on jo poistettu, vastaa 404 embed_link_not_found.
Oikeuslaajuudet embed:mint
Parametrit
Lingara-Versionheaderstringvalinnainen- API-versio, jolla tähän pyyntöön vastataan. Ilman sitä käyttötunnus saa version, johon sen asiakas on kiinnitetty, ja pyyntö ilman tunnusta saa nykyisen version. Vielä kehitteillä olevaan versioon pääsee vain nimeämällä sen tässä. Tuntemattomaan versioon vastataan
400koodillaapi_version_unknown.GET /v1/versionsluettelee versiot. player_refpathstringpakollinenplayer_ref, jolla myönsit pelaajan tunnukset, prosenttikoodattuna:guild/42onguild%2F42.
Vastaukset
204 Linkitys on päättynyt
Virheet
410application/json- API-versio, jolla tähän pyyntöön vastataan, on lopetettu. Lähetä tuettu versio
Lingara-Version-otsakkeessa tai kiinnitä asiakas toiseen versioon. 4XXapplication/json- Pyyntö hylättiin.
codekertoo syyn, jaerrorkertoo sen sanoin. 503application/json · text/plain- Palvelu ei ole tilapäisesti käytettävissä; yritä uudelleen
Retry-After-otsakkeen ilmoittaman sekuntimäärän jälkeen. Huoltokatkon aikana runko on pelkkää tekstiä virhekehyksen sijaan. 5XXapplication/json- Pyyntö hylättiin.
codekertoo syyn, jaerrorkertoo sen sanoin.
codestringpakollinenMiksi pyyntö hylättiin, pysyvänä koodina, jonka mukaan voit haarautua: esimerkiksi
insufficient_scope(403),rate_limited(429) ja käytön mukaan laskutettavalle asiakkaallespend_cap_reached(402) jametered_billing_inactive(402).errorstringpakollinen
Esimerkki
curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
-H "Authorization: Bearer $LINGARA_TOKEN"Jos käännös ja englanninkielinen viite poikkeavat toisistaan, englanninkielinen viite on oikea.