API:Login/es

MediaWiki API puede requerir que tu aplicación o cliente proporcione credenciales de usuario autenticado e inicie sesión para (a) consultar información o acciones de modificación-de-datos (b) realizando grandes consultas con un mayor límite de solicitud.



Dos métodos para autenticar
Hay dos maneras para autenticar al MediaWiki Acción API:



Método 1. login
Los bots y otras aplicaciones no interactivas deben usar owner-only OAuth consumer si está disponible, ya que es más seguro. Si no está disponible o no es aplicable al cliente, la acción  se puede usar con bot passwords.



Ejemplo


Respuesta


Código de muestra


Errores posibles


Método 2. clientlogin
Las aplicaciones interactivas, como editores personalizados o aplicaciones de vigilancia que proporcionan un servicio sin intención de reemplazar completamente el sitio web o las aplicaciones móviles que apuntan a reemplazar completamente el acceso a la interfaz de usuario basada en la web, tendrían que utilizar la acción. Sin embargo, uno debería preferir usar si está disponible para autenticar la herramienta, ya que es más fácil y más seguro. Este módulo está disponible desde MediaWiki 1.27.



API Documentación


Ejemplo 1: Proceso para un wiki sin extensiones especiales de autenticación


Petición de CORREO
Obtén token login en la petición anterior a través de.

Respuesta


Código de ejemplo


Ejemplo 2: Proceso para un wiki con extensiones especiales de autentificación
Una wiki con extensiones de autenticación especiales como (captchas),,  (dos factores de autenticación) puede tener un proceso de autentificación más complicado. Los campos específicos también pueden ser necesarios en ese caso, cuya descripción se puede obtener de la consulta de.



Paso 1: Responde el Captcha y selecciona OpenID autentificación


Paso 2: Volver de OpenID


Paso 3: autentificación de Dos factores
Nota: En ciertos casos, es posible recibir una respuesta, por ejemplo, si la extensión OpenID Connecta no tenía asignado para la cuenta OpenID a ningún usuario local. En este caso, el cliente puede reiniciar el proceso de inicio de sesión desde el principio o puede cambiar a creación de cuenta, en cualquier caso pasando el parámetro loginpreservestate o createpreservestate para preservar algún estado.



Notas adicionales
cualquier funcionalidad API.
 * En wikis que permiten edición anónima, es posible editar a través del API sin iniciar sesión, pero es altamente recomendable que inicies sesión. En wikis privados, es necesario iniciar sesión para usar
 * Es recomendado crear una cuenta de usuario separada para tu aplicación. Esto es especialmente importante si tu aplicación está llevando a cabo edición automatizada o invocando consultas grandes o rendimiento-intensivo. Con eso, es fácil rastrear los cambios realizados por la aplicación y aplicar derechos especiales a la cuenta de la aplicación.
 * Si estás enviando una petición que debería ser hecha por un usuario conectado, añade el parámetro  a la petición que estás enviando en orden de verificar si el usuario ha iniciado sesión. Si el usuario no ha iniciado sesión, un error   Será devuelto.
 * Para verificar si una cuenta tiene derechos de bot, añade el parámetro  a la petición. Si la cuenta no tiene derechos de bot, un código error   será retornado.

<span id="See_also">

Véase también

 * - Devuelve información sobre el usuario actualmente conectado
 * Interactive login with action=clientlogin in mwapi