API:Login/fr

La connexion est nécessaire au serveur pour reconnaître l'utilisateur connecté. À chaque requête sur api.php, le cookie créé par la connexion doit être transmis.

Exemple
Note : Dans cet exemple, tous les paramètres sont transmis via la méthode GET pour des raisons de simplicité. Cependant, action=login nécessite la méthode POST. La méthode GET retournera une erreur.

Vous devez ajoutez le paramètre  contenant le nom de domaine pour l'authentification si vous utilisez un greffon d'authentification comme Extension:LDAP Authentication.

Générer les cookies manuellement
Une connexion réussie créera les cookies de droits, mais si vous ne pouvez y accéder, vous pouvez aussi les générer à partir des données retournées. Dans l'exemple précédent, vous devriez générer les cookies suivants :


 * enwikiUserName = Bob (valeur du champ lgusername)
 * enwikiUserID = 12345 (valeur du champ lguserid)
 * enwikiToken = b5780b6e2f27e20b450921d9461010b4 (valeur du champ lgtoken)
 * enwiki_session = 08nj1ioefhlvmdjfor5to3mvv5 (valeur du champ sessionid)

Notez que la partie enwiki</tt> varie d'un wiki à l'autre, et est retournée dans le champ cookieprefix</tt>.

Erreurs
Les erreurs sont retournées dans le champ result</tt>. Ses valeurs possibles sont alors :


 * NoName</tt>
 * Le paramètre lgname</tt> n'est pas défini.
 * Illegal</tt>
 * Vous avez fourni un nom d'utilisateur illégal.
 * NotExists</tt>
 * Vous avez fourni un nom d'utilisateur inexistant.
 * EmptyPass</tt>
 * Le paramètre lgpassword</tt> est vide ou indéfini.
 * WrongPass</tt>
 * Le mot de passe est incorrect.
 * WrongPluginPass</tt>
 * Même signification que WrongPass</tt>, retourné lorsque c'est un plugin d'authentification plutôt que MediaWiki lui-même qui a rejeté le mot de passe.
 * CreateBlocked</tt>
 * Le wiki a tenté de créer automatiquement un nouveau compte pour vous, mais votre adresse IP est bloquée à la création de comptes.
 * NeedToWait</tt>
 * Votre délai inter-requêtes n'est pas encore écoulé. Voir ci-dessous.

Délai inter-requêtes
Pour des raisons de sécurité, ce module est protégé par un délai inter-requêtes. Une authentification qui échoue nécessite que vous attendiez 5 secondes avant de réutiliser le module ou que vous vous connectiez à partir de Special:Connexion. Chaque tentative ratée supplémentaire doublera le délai nécessaire. Une erreur NeedToWait</tt> ne recommence pas le délai. Le nombre de secondes avant lesquelles vous pourrez réessayer est retourné dans le champ wait</tt>. Cette fonction est activée seulement dans les serveurs supportant memcaching.

Liens externes

 * Exemple de connextion avec PHP (nécessite Snoopy)