API:Login/es

action=login envía diversos tokens (identificadores numéricos) que son requeridos por el servidor para reconocer usuarios logueados (logged-in, que iniciaron sesión). In cada llamada a api.php, debe pasarse una cookie creada en esta petición.

Ejemplo de petición
Nota: En este ejemplo, todos los parámetros son pasados por el método GET sólo para hacerlo más simple. De todas formas, action=login emplea el método POST; sino se producirá un error.

Debe agregarse el parámetro, que contiene el nombre de dominio para la autenticación, si estás usando un plug-in de autenticación como el Extension:LDAP Authentication.

Construyendo la cookie manualmente
Una consulta action=login exitosa debería crear una cookie correcta, pero si no es capaz de procesarla, también puede construirla con los datos devueltos. En el ejemplo anterior, debería crearse la siguiente cookie: Nótese que el prefijo  es diferente para cada wiki, y es tomado del campo.
 * eswikiUserName =  (del campo  );
 * eswikiUserID =  (del campo  );
 * eswikiToken =  (del campo  );
 * eswiki_session =  (del campo  );

Errores
Se informa de los errores a través del campo, cuyos posibles valores son:

Throttling
Por razones de seguridad, el módulo tiene throttling. Esto implica que un intento de iniciar sesión fallido, requerirá que se identifique por la página de inicio de sesión estándar, o espere un tiempo antes de iniciar sesión. Ante el primer error la demora es de 5 segundos, cada intento fallido subsecuente doblará la demora. Reintentar antes de ese tiempo producirá un error, pero no reiniciará la cuenta de tiempo. El número de segundos que debe esperar hasta el próximo intento es devuelto por el campo. Esta opción sólo está habilitada para servidores que soportan memcaching.

Enlaces externos

 * Ejemplo de código de autenticación en PHP (requiere Snoopy).