MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

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

action=clientlogin (login)

(main | clientlogin)
  • Questo modulo accetta solo richieste POST.
  • Fonte: MediaWiki
  • Licenza: GPL-2.0-or-later

Accedi al wiki utilizzando il flusso interattivo.

La procedura generale per usare questo modulo è:

  1. Ottenere i campi disponibili da action=query&meta=authmanagerinfo con amirequestsfor=login, e un token login 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 loginreturnurl 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 logincontinue e i campi rilevanti settati, quindi ripeti il punto 4.
    • Se hai ricevuto REDIRECT, dirigi l'utente a redirecttarget e aspetta che ritorni a loginreturnurl. A quel punto esegui un post a questo modulo con logincontinue 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:
loginrequests

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

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

Formato da utilizzare per per la restituzione dei messaggi.

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

Merge field information for all authentication requests into one array.

Tipo: booleano (dettagli)
loginpreservestate

Conserva lo stato da un precedente tentativo di accesso non riuscito, se possibile.

Tipo: booleano (dettagli)
loginreturnurl

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

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 logincontinue a questo modulo API.

logincontinue

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

Tipo: booleano (dettagli)
logintoken

Un token "login" 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=login (o una precedente risposta da questo modulo, se applicabile) per determinare le richieste disponibili e i campi usati da queste.
Esempi:
Avvia il processo di accesso alla wiki come utente Example con password ExamplePassword.
api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [apri in una sandbox]
Continua l'accesso dopo una risposta dell'UI per l'autenticazione a due fattori, fornendo un OATHToken di 987654.
api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [apri in una sandbox]