Lingara Lingara Ohjeet Oppaat API Kirjastot Sovellukset Rakenna Upotus Verkkosovellus
Kieli: Suomi

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 400 koodilla api_version_unknown. GET /v1/versions luettelee versiot.
player_refpathstringpakollinen
player_ref, jolla myönsit pelaajan tunnukset, prosenttikoodattuna: guild/42 on guild%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. code kertoo syyn, ja error kertoo 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. code kertoo syyn, ja error kertoo sen sanoin.
codestringpakollinen

Miksi pyyntö hylättiin, pysyvänä koodina, jonka mukaan voit haarautua: esimerkiksi insufficient_scope (403), rate_limited (429) ja käytön mukaan laskutettavalle asiakkaalle spend_cap_reached (402) ja metered_billing_inactive (402).

errorstringpakollinen

Esimerkki

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

Käytätkö mieluummin kirjastoa? Katso Kirjastot-osio.

Jos käännös ja englanninkielinen viite poikkeavat toisistaan, englanninkielinen viite on oikea.