I-link ang isang manlalaro sa kanilang Lingara account

Bersyon ng API 2026-10-virile-dragon

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

Ini-link ang isa sa iyong mga manlalaro sa Lingara account na kakabigay lang ng access sa iyong app. Tawagin ito gamit ang delegated token na natanggap ng iyong server para sa account na iyon, hindi kailanman gamit ang sariling token ng iyong client. Mula noon, kumikilos ang mga token ng manlalaro bilang ang account, hanggang sa pinapayagan ng grant: humingi ng events:read o wala kang maririnig tungkol sa manlalaro pagkatapos ng link. Lumilipat sa account ang mga tapos nang plano; nananatili ang planong isinusulat pa hanggang tumawag ka ulit. Ligtas ulitin: ang pag-uulit ay sumasagot ng existing at inililipat ang hindi nailipat dati. Walang gastos sa iyo ang pag-link.

Mga scope embed:play

Mga parameter

Lingara-Versionheaderstringopsyonal: Ang bersyon ng API na gagamitin sa pagsagot sa kahilingang ito. Kung wala ito, makukuha ng access token ang bersyong naka-pin sa client nito, at makukuha ng kahilingang walang token ang kasalukuyang bersyon. Maaabot lang ang bersyong dine-develop pa sa pamamagitan ng pagpangalan dito. Ang hindi kilalang bersyon ay sinasagot ng 400 na may code na api_version_unknown. Inililista ng GET /v1/versions ang mga bersyon.
player_refpathstringkailangan: Ang player_ref na ginamit mo sa paggawa ng mga token ng manlalaro, percent-encoded: ang guild/42 ay guild%2F42.

Mga tugon

200 Ang link ng manlalaro

statusLinkStatuskailangan
subjectstringkailangan: Ang lgr_sub_ ng account: ang dala ng mga event ng manlalarong ito mula ngayon.
previous_subjectstringkailangan: Ang lgr_sub_ ng guest: ang pinananatili ng mga naunang event ng manlalaro. Ipadala ang dalawa sa iisang player_ref.
linked_atstringkailangan: Kailan ginawa ang link. Sa sagot na existing, ang oras ng unang tawag.
scopesarray of stringkailangan: Ang pinakamaraming kayang hawakan ngayon ng isang token para sa manlalarong ito: ang ibinigay ng account, mula sa mga scope na kayang dalhin ng token ng manlalaro.
carriedobjectkailangan: Mga row na inilipat ng tawag na ito sa account, bawat table. Ang mga table lang na may bilang ang lumalabas.
keptobjectkailangan: Mga row na iniwan ng tawag na ito sa guest, bawat table: planong isinusulat pa, o row na mayroon na ang account. Tumawag ulit kapag may natapos nang plano sa lesson_plans dito.

Mga error

402application/json: Tinanggihan ang tawag ng isang metered client bago ito nakagastos ng anuman. spend_cap_reached: naabot na ng client o ng account nito ang buwanang limitasyon sa paggastos; itaas ang limitasyon sa pahinang Mga integration. metered_billing_inactive: hindi aktibo ang usage billing para sa account na ito; i-set up ito, o i-update ang paraan ng pagbabayad, sa pahinang Mga integration.
410application/json: Itinigil na ang bersyon ng API na ginagamit sa pagsagot sa kahilingang ito. Magpadala ng suportadong bersyon sa Lingara-Version, o i-pin ang client sa ibang bersyon.
4XXapplication/json: Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.
503application/json · text/plain: Pansamantalang hindi available ang serbisyo; subukang muli pagkatapos ng bilang ng segundong nasa Retry-After. Habang may maintenance, plain text ang body sa halip na ang error envelope.
5XXapplication/json: Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

codestringkailangan: Kung bakit tinanggihan ang request, bilang isang matatag na code na mapagbabatayan ng iyong programa: halimbawa insufficient_scope (403), rate_limited (429) at, para sa isang metered client, spend_cap_reached (402) at metered_billing_inactive (402).
errorstringkailangan

Halimbawa

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

Mas gusto ang library? Tingnan ang seksyong Mga library.

Kung magkaiba ang isang salin at ang sangguniang Ingles, ang sangguniang Ingles ang tama.