Adjuta sur le API de MediaWiki

Iste es un pagina de documentation generate automaticamente sur le API de MediaWiki.

Documentation e exemplos: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=clientlogin (login)

(main | clientlogin)
  • Iste modulo require derectos de scriptura.
  • Iste modulo accepta solmente le requestas POST.
  • Fonte: MediaWiki
  • Licentia: GPL-2.0-or-later

Aperir session in le wiki usante le fluxo interactive.

Le procedura general pro usar iste modulo es:

  1. Recuperar le campos disponibile de action=query&meta=authmanagerinfo con amirequestsfor=login, e un token login de action=query&meta=tokens.
  2. Presentar le campos al usator, e obtener lor submission.
  3. Inviar a iste modulo, forniente loginreturnurl e qualcunque campos relevante.
  4. Verificar le status (stato) in le responsa.
    • Si tu recipeva PASS o FAIL, tu es finite. Le operation ha succedite o fallite.
    • Si tu recipeva UI, presenta le nove campos al usator e obtene lor submission. Postea invia a iste modulo con logincontinue e le campos relevante definite, e repete le passo 4.
    • Si tu recipeva REDIRECT, dirige le usator al redirecttarget (destination del redirection) e attende le retorno a loginreturnurl. Postea invia a iste modulo con logincontinue e qualcunque campos passate al URL de retorno, e repete le passo 4.
    • Si tu recipeva RESTART, isto significa que le authentication functionava ma nos non ha un conto de usator ligate. Tu poterea tractar isto como UI o como FAIL.
Parametros specific:
Altere parametros general es disponibile.
loginrequests

Usar solmente iste requestas de authentication per le id restituite ab action=query&meta=authmanagerinfo con amirequestsfor=login o ab un responsa anterior de iste modulo.

Separar valores con | o un alternativa.
Le numero maxime de valores es 50 (500 pro clientes al quales ha essite permittite limites plus alte).
loginmessageformat

Formato a usar pro restituer messages.

Un del sequente valores: html, none, raw, wikitext
Predefinite: wikitext
loginmergerequestfields

Fusionar le information de campo pro tote le requestas de authentication in un sol matrice.

Typo: booleano (detalios)
loginpreservestate

Conservar le stato de un previe tentativa de apertura de session fallite, si possibile.

Typo: booleano (detalios)
loginreturnurl

URL de retorno pro fluxos de authentication de tertie parte, debe esser absolute. O iste o logincontinue es obligatori.

Quando se recipe un responsa REDIRECT, on normalmente aperira un navigator o vista web al URL redirecttarget specificate pro un fluxo de authentication de tertie parte. Quando illo termina, le tertie parte inviara le navigator o vista web a iste URL. Tu debe extraher tote parametros de requesta o POST del URL e passar los como un requesta logincontinue a iste modulo API.

logincontinue

Iste requesta es un continuation post un responsa anterior de UI o REDIRECT. O iste o loginreturnurl es obligatori.

Typo: booleano (detalios)
logintoken

Un token "login" recuperate ab action=query&meta=tokens

Iste parametro es obligatori.
*
Iste modulo accepta parametros additional dependente del requestas de authentication disponibile. Usa action=query&meta=authmanagerinfo con amirequestsfor=login (o un responsa anterior ab iste modulo, si applicabile) pro determinar le requestas disponibile e le campos que illos usa.
Exemplos:
Comenciar le processo de aperir session in le wiki como le usator Exemplo con le contrasigno ExemploDeContrasigno.
api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [aperir in sabliera]
Continuar a aperir session post un responsa UI pro authentication bifactorial, forniente un OATHToken de 987654.
api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [aperir in sabliera]