Ayuda de la API de MediaWiki

Esta es una página de documentación autogenerada de la API de MediaWiki.

Documentación y ejemplos: https://www.mediawiki.org/wiki/API

action=clientlogin (login)

(main | clientlogin)
  • Este módulo solo acepta solicitudes POST.
  • Fuente: MediaWiki
  • Licencia: GPL-2.0+

Entrar en wiki usando el flujo interactivo.

The general procedure to use this module is:

  1. Fetch the fields available from action=query&meta=authmanagerinfo with amirequestsfor=login, and a login token from action=query&meta=tokens.
  2. Present the fields to the user, and obtain their submission.
  3. Post to this module, supplying loginreturnurl and any relevant fields.
  4. Check the status in the response.
    • If you received PASS or FAIL, you're done. The operation either succeeded or it didn't.
    • If you received UI, present the new fields to the user and obtain their submission. Then post to this module with logincontinue and the relevant fields set, and repeat step 4.
    • If you received REDIRECT, direct the user to the redirecttarget and wait for the return to loginreturnurl. Then post to this module with logincontinue and any fields passed to the return URL, and repeat step 4.
    • If you received RESTART, that means the authentication worked but we don't have a linked user account. You might treat this as UI or as FAIL.
Parámetros:
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.

Separar los valores con | o con una alternativa. El número máximo de los valores es 50 (500 para los bots).
loginmessageformat

Formato utilizado para los mensajes devueltos.

Uno de los siguientes valores: html, wikitext, raw, none
Predeterminado: wikitext
loginmergerequestfields

Combinar la información de los campos para todas las peticiones de autentificación en una matriz.

Tipo: booleano/lógico (detalles)
loginpreservestate

Preservar el estado de un intento fallido anterior de inicio de sesión, si es posible.

Tipo: booleano/lógico (detalles)
loginreturnurl

Return URL for third-party authentication flows, must be absolute. Either this or logincontinue is required.

Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a logincontinue request to this API module.

logincontinue

This request is a continuation after an earlier UI or REDIRECT response. Either this or loginreturnurl is required.

Tipo: booleano/lógico (detalles)
logintoken

A "login" token retrieved from action=query&meta=tokens

Este parámetro es obligatorio.
*
This module accepts additional parameters depending on the available authentication requests. Use action=query&meta=authmanagerinfo with amirequestsfor=login (or a previous response from this module, if applicable) to determine the requests available and the fields that they use.
Ejemplos:
Comenzar el proceso para iniciar sesión en el wiki como usuario Example con la contraseña ExamplePassword.
api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [abrir en la zona de pruebas]
Continuar el inicio de sesión después de una respuesta de la UI a la autenticación de dos pasos, en la que devuelve un OATHToken de 987654.
api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [abrir en la zona de pruebas]