Linkitä pelaaja hänen Lingara-tiliinsä

API-versio 2026-10-virile-dragon

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

Linkittää yhden pelaajistasi Lingara-tiliin, joka juuri myönsi sovelluksellesi pääsyn. Kutsu sitä delegoidulla tunnisteella, jonka palvelimesi sai kyseiselle tilille, älä koskaan asiakkaasi omalla tunnisteella. Siitä lähtien pelaajan tunnisteet toimivat tilinä, niin pitkälle kuin myöntö sallii: pyydä events:read, tai et kuule pelaajasta mitään linkityksen jälkeen. Valmiit suunnitelmat siirtyvät tilille; vielä kirjoitettava suunnitelma jää, kunnes kutsut uudelleen. Turvallista toistaa: toisto vastaa existing ja siirtää sen, mitä ei aiemmin voitu siirtää. Linkittäminen ei maksa sinulle mitään.

Oikeuslaajuudet embed:play

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

200 Pelaajan linkitys

statusLinkStatuspakollinen
subjectstringpakollinen: Tilin lgr_sub_: mitä tämän pelaajan tapahtumat kantavat tästä eteenpäin.
previous_subjectstringpakollinen: Vieraan lgr_sub_: mitä pelaajan aiemmat tapahtumat säilyttävät. Ohjaa molemmat samaan player_ref-arvoon.
linked_atstringpakollinen: Milloin linkitys luotiin. existing-vastauksessa ensimmäisen kutsun aika.
scopesarray of stringpakollinen: Enintään se, mitä tämän pelaajan tunniste voi nyt sisältää: mitä tili myönsi niistä oikeuksista, joita pelaajan tunniste voi kantaa.
carriedobjectpakollinen: Rivit, jotka tämä kutsu siirsi tilille, taulukoittain. Vain taulukot, joilla on määrä, näkyvät.
keptobjectpakollinen: Rivit, jotka tämä kutsu jätti vieraalle, taulukoittain: vielä kirjoitettava suunnitelma tai rivi, joka tilillä jo oli. Kutsu uudelleen, kun lesson_plans sisältää täällä valmistuneen suunnitelman.

Virheet

402application/json: Käytön mukaan laskutettavan asiakkaan kutsu hylättiin ennen kuin se kulutti mitään. spend_cap_reached: asiakas tai sen tili on saavuttanut kuukausittaisen kulutusrajansa; nosta rajaa Integraatiot-sivulla. metered_billing_inactive: käytön mukainen laskutus ei ole tällä tilillä käytössä; ota se käyttöön tai päivitä maksutapa Integraatiot-sivulla.
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 PUT "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.