Unganisha mchezaji na akaunti yake ya Lingara

Vigezo

Lingara-Versionheaderstringsi lazima

Toleo la API la kutumia kujibu ombi hili. Bila hilo, tokeni ya ufikiaji hupata toleo ambalo mteja wake ameunganishwa nalo, na ombi lisilo na tokeni hupata toleo la sasa. Toleo ambalo bado linaendelezwa linafikiwa tu kwa kulitaja hapa. Toleo lisilojulikana hujibiwa 400 pamoja na msimbo api_version_unknown. GET /v1/versions huorodhesha matoleo.

player_refpathstringinahitajika

player_ref uliyotumia kutoa tokeni za mchezaji, iliyosimbwa kwa asilimia: guild/42 ni guild%2F42.

Majibu

200 Muunganisho wa mchezaji

statusLinkStatusinahitajika

subjectstringinahitajika

lgr_sub_ ya akaunti: kile ambacho matukio ya mchezaji huyu yatabeba kuanzia sasa.

previous_subjectstringinahitajika

lgr_sub_ ya mgeni: kile ambacho matukio ya awali ya mchezaji yanahifadhi. Elekeza zote mbili kwa player_ref ileile.

linked_atstringinahitajika

Muunganisho ulipoundwa. Katika jibu la existing, wakati wa mwito wa kwanza.

scopesarray of stringinahitajika

Kiwango cha juu ambacho tokeni ya mchezaji huyu inaweza kushikilia sasa: kile akaunti iliruhusu, kati ya mawanda ambayo tokeni ya mchezaji inaweza kubeba.

carriedobjectinahitajika

Safu ambazo mwito huu ulihamisha kwenye akaunti, kwa kila jedwali. Majedwali yenye idadi pekee ndiyo huonekana.

keptobjectinahitajika

Safu ambazo mwito huu uliacha kwa mgeni, kwa kila jedwali: mpango ambao bado unaandikwa, au safu ambayo akaunti tayari ilikuwa nayo. Ita tena mara lesson_plans hapa itakapokuwa na mpango uliokamilika.

Hitilafu

402application/json

Simu ya mteja anayetozwa kwa matumizi imekataliwa kabla haijatumia chochote. spend_cap_reached: mteja au akaunti yake imefikia kikomo chake cha matumizi ya pesa cha kila mwezi; ongeza kikomo kwenye ukurasa wa Miunganisho. metered_billing_inactive: utozaji kwa matumizi haujawashwa kwa akaunti hii; uweke, au usasishe njia ya malipo, kwenye ukurasa wa Miunganisho.

410application/json

Toleo la API linalotumika kujibu ombi hili limesitishwa. Tuma toleo linalotumika katika Lingara-Version, au unganisha mteja na toleo lingine.

4XXapplication/json

Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

503application/json · text/plain

Huduma haipatikani kwa muda; jaribu tena baada ya idadi ya sekunde zilizo katika Retry-After. Wakati wa matengenezo, mwili wa jibu ni maandishi ya kawaida badala ya bahasha ya hitilafu.

5XXapplication/json

Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

codestringinahitajika

Sababu ya ombi kukataliwa, kama msimbo thabiti wa kufanyia maamuzi: kwa mfano insufficient_scope (403), rate_limited (429) na, kwa mteja anayetozwa kwa matumizi, spend_cap_reached (402) na metered_billing_inactive (402).

errorstringinahitajika

Mfano

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

Unapendelea maktaba? Tazama sehemu ya Maktaba.