Collega un giocatore al suo account Lingara

Versione API 2026-10-virile-dragon

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

Collega uno dei tuoi giocatori all'account Lingara che ha appena dato accesso alla tua app. Chiamala con il token delegato che il tuo server ha ricevuto per quell'account, mai con il token del tuo client. Da quel momento i token del giocatore agiscono come l'account, nei limiti consentiti dall'autorizzazione: chiedi events:read o dopo il collegamento non saprai più nulla del giocatore. I piani completati passano all'account; un piano ancora in scrittura resta finché non richiami. Si può ripetere senza rischi: una ripetizione risponde existing e sposta ciò che prima non si poteva spostare. Il collegamento non ti costa nulla.

Scope embed:play

Parametri

Lingara-Versionheaderstringfacoltativo: La versione dell'API con cui rispondere a questa richiesta. Senza di essa, un token di accesso riceve la versione a cui è associato il suo client e una richiesta senza token riceve la versione corrente. La versione ancora in sviluppo si raggiunge solo indicandola qui. Una versione sconosciuta risponde 400 con il codice api_version_unknown. GET /v1/versions elenca le versioni.
player_refpathstringobbligatorio: Il player_ref con cui hai emesso i token del giocatore, codificato in percentuale: guild/42 diventa guild%2F42.

Risposte

200 Il collegamento del giocatore

statusLinkStatusobbligatorio
subjectstringobbligatorio: Il lgr_sub_ dell'account: ciò che gli eventi di questo giocatore portano da ora in poi.
previous_subjectstringobbligatorio: Il lgr_sub_ dell'ospite: ciò che conservano gli eventi precedenti del giocatore. Instrada entrambi verso lo stesso player_ref.
linked_atstringobbligatorio: Quando è stato creato il collegamento. In una risposta existing, l'ora della prima chiamata.
scopesarray of stringobbligatorio: Il massimo che un token per questo giocatore può ora avere: ciò che l'account ha concesso, tra gli ambiti che il token di un giocatore può portare.
carriedobjectobbligatorio: Righe che questa chiamata ha spostato nell'account, per tabella. Compaiono solo le tabelle con un conteggio.
keptobjectobbligatorio: Righe che questa chiamata ha lasciato all'ospite, per tabella: un piano ancora in scrittura, o una riga che l'account aveva già. Richiama quando lesson_plans qui contiene un piano completato.

Errori

402application/json: La chiamata di un client con fatturazione a consumo è stata rifiutata prima che spendesse qualcosa. spend_cap_reached: il client o il suo account ha raggiunto il limite di spesa mensile; alza il limite nella pagina Integrazioni. metered_billing_inactive: la fatturazione a consumo non è attiva per questo account; configurala o aggiorna il metodo di pagamento nella pagina Integrazioni.
410application/json: La versione dell'API con cui si risponde a questa richiesta è stata dismessa. Invia una versione supportata in Lingara-Version, oppure associa il client a un'altra versione.
4XXapplication/json: La richiesta è stata rifiutata. code dice il motivo, e error lo spiega a parole.
503application/json · text/plain: Il servizio è temporaneamente non disponibile; riprova dopo il numero di secondi indicato in Retry-After. Durante la manutenzione il corpo è testo semplice anziché l'envelope di errore.
5XXapplication/json: La richiesta è stata rifiutata. code dice il motivo, e error lo spiega a parole.

codestringobbligatorio: Perché la richiesta è stata rifiutata, come codice stabile su cui diramare la logica: per esempio insufficient_scope (403), rate_limited (429) e, per un client con fatturazione a consumo, spend_cap_reached (402) e metered_billing_inactive (402).
errorstringobbligatorio

Esempio

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

Preferisci una libreria? Vedi la sezione Librerie.

In caso di discrepanza tra una traduzione e il riferimento in inglese, fa fede il riferimento in inglese.