MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=linkaccount (link)
- Questo modulo richiede i diritti di scrittura.
- Questo modulo accetta solo richieste POST.
- Fonte: MediaWiki
- Licenza: GPL-2.0-or-later
Collegamento di un'utenza di un provider di terze parti all'utente corrente.
La procedura generale per usare questo modulo è:
- Ottenere i campi disponibili da action=query&meta=authmanagerinfo con amirequestsfor=link, e un token csrf da action=query&meta=tokens.
- Mostra i campi all'utente e ottieni i dati che invia.
- Esegui un post a questo modulo, fornendo linkreturnurl e ogni campo rilevante.
- 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.
- 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.
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- linkmessageformat
Formato da utilizzare per per la restituzione dei messaggi.
- Uno dei seguenti valori: html, none, raw, wikitext
- Default: 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
- This parameter is required.
- *
- 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.
- Avvia il processo di collegamento ad un'utenza da Example.
- api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [apri in una sandbox]