Lîstikvanekî bi hesabê wî yê Lingara ve girê bide

Guhertoya API 2026-10-virile-dragon

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

Yek ji lîstikvanên te bi wî hesabê Lingara ve girê dide ku nû destûr da sepana te. Bi tokena wekaletê ya ku serverê te ji bo wî hesabî wergirtiye bang bike, qet bi tokena muşteriyê xwe ya xwe re na. Ji wê gavê ve tokenên lîstikvan wekî hesab tevdigerin, heta ku destûr dihêle: events:read bixwaze, wekî din piştî girêdanê tu tiştekî der barê lîstikvan de nabihîzî. Planên temambûyî diçin hesab; planek ku hîn tê nivîsandin dimîne heta ku tu dîsa bang bikî. Dubarekirin bê xeter e: dubarekirin bersiva existing dide û tiştê ku berê nedihat guhestin diguhezîne. Girêdan tu lêçûnê li te nake.

Scope embed:play

Parametre

Lingara-Versionheaderstringvebijarkî: Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi 400 û koda api_version_unknown tê bersivandin. GET /v1/versions guhertoyan rêz dike.
player_refpathstringpêwîst: Ew player_ref a ku te tokenên lîstikvan pê derxistin, bi kodkirina sedî: guild/42 dibe guild%2F42.

Bersiv

200 Girêdana lîstikvan

statusLinkStatuspêwîst
subjectstringpêwîst: lgr_sub_ ya hesab: tiştê ku bûyerên vî lîstikvanî ji niha ve hilgirin.
previous_subjectstringpêwîst: lgr_sub_ ya mêvan: tiştê ku bûyerên berê yên lîstikvan diparêzin. Herduyan jî bişîne heman player_ref.
linked_atstringpêwîst: Kengê girêdan hate çêkirin. Di bersiva existing de, dema banga yekem.
scopesarray of stringpêwîst: Herî zêde ya ku tokenek ji bo vî lîstikvanî niha dikare hebe: ya ku hesab destûr daye, ji wan qadan ku tokena lîstikvan dikare hilgire.
carriedobjectpêwîst: Rêzên ku vê bangê guhestin hesab, li gorî tabloyê. Tenê tabloyên bi hejmar xuya dibin.
keptobjectpêwîst: Rêzên ku vê bangê li cem mêvan hiştin, li gorî tabloyê: planek ku hîn tê nivîsandin, an rêzek ku hesab jixwe hebû. Dema ku lesson_plans li vir planek temambûyî hebe, dîsa bang bike.

Çewtî

402application/json: Bangeke klienteke pîvandî hat redkirin berî ku tiştek xerc bike. spend_cap_reached: klient an hesabê wê gihîştiye sînorê xercê yê mehane; sînor li rûpela Entegrasyon bilind bike. metered_billing_inactive: fatûrekirina li gorî bikaranînê ji bo vî hesabî ne çalak e; wê li rûpela Entegrasyon saz bike an rêbaza dayînê nû bike.
410application/json: Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di Lingara-Version de bişîne, an klientê bi guhertoyeke din ve girê bide.
4XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.
503application/json · text/plain: Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di Retry-After de dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê.
5XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.

codestringpêwîst: Çima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne insufficient_scope (403), rate_limited (429) û, ji bo klienteke pîvandî, spend_cap_reached (402) û metered_billing_inactive (402).
errorstringpêwîst

Mînak

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

Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.

Ger wergerek û referansa Îngilîzî ji hev cuda bin, referansa Îngilîzî rast e.