MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/API

action=linkaccount (link)

(main | linkaccount)
  • Questo modulo richiede i diritti di scrittura.
  • Questo modulo accetta solo richieste POST.
  • Fonte: MediaWiki
  • Licenza: GPL-2.0+

Collegamento di un'utenza di un provider di terze parti all'utente corrente.

La procedura generale per usare questo modulo è:

  1. Ottenere i campi disponibili da action=query&meta=authmanagerinfo con amirequestsfor=link, e un token csrf da action=query&meta=tokens.
  2. Mostra i campi all'utente e ottieni i dati che invia.
  3. Esegui un post a questo modulo, fornendo linkreturnurl e ogni campo rilevante.
  4. Controlla status nella response.
    • Se hai ricevuto PASS o FAIL, hai finito. L'operazione nel primo caso è andata a buon fine, nel secondo no.
    • Se hai ricevuto UI, mostra i nuovi campi all'utente e ottieni i dati che invia. Esegui un post a questo modulo con linkcontinue e i campi rilevanti settati, quindi ripeti il punto 4.
    • Se hai ricevuto REDIRECT, dirigi l'utente a redirecttarget e aspetta che ritorni a linkreturnurl. A quel punto esegui un post a questo modulo con linkcontinue e ogni campo passato all'URL di ritorno, e ripeti il punto 4.
    • Se hai ricevuto RESTART, vuol dire che l'autenticazione ha funzionato ma non abbiamo un account collegato. Potresti considerare questo caso come UI o come FAIL.
Parametri:
linkrequests

Only use these authentication requests, by the id returned from action=query&meta=authmanagerinfo with amirequestsfor=link or from a previous response from this module.

Separa i valori con | o alternativa. Il numero massimo di valori è 50 (500 per i bot).
linkmessageformat

Formato da utilizzare per per la restituzione dei messaggi.

Uno dei seguenti valori: html, wikitext, raw, none
Predefinito: wikitext
linkmergerequestfields

Merge field information for all authentication requests into one array.

Tipo: booleano (dettagli)
linkreturnurl

URL di ritorno per i flussi di autenticazione di terze parti, deve essere assoluto. E' necessario fornirlo, oppure va fornito linkcontinue.

Alla ricezione di una risposta REDIRECT, in genere si apre un browser o una vista web all'URL specificato redirecttarget per un flusso di autenticazione di terze parti. Quando questo è completato, la terza parte invierà il browser o la vista web a questo URL. Dovresti estrarre qualsiasi parametro POST o della richiesta dall'URL e passarli come un request linkcontinue a questo modulo API.

linkcontinue

Questa richiesta è una continuazione dopo una precedente risposta UI o REDIRECT. È necessario fornirlo, oppure fornire linkreturnurl.

Tipo: booleano (dettagli)
linktoken

Un token "csrf" recuperato da action=query&meta=tokens

Questo parametro è obbligatorio.
*
Questo modulo accetta parametri aggiuntivi a seconda delle richieste di autenticazione disponibili. Utilizza action=query&meta=authmanagerinfo con amirequestsfor=link (o una precedente risposta da questo modulo, se applicabile) per determinare le richieste disponibili e i campi usati da queste.