Aide de l’API MediaWiki

Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.

Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=clientlogin (login)

(main | clientlogin)
  • Ce module accepte seulement les requêtes POST.
  • Source : MediaWiki
  • Licence : GPL-2.0-or-later

Se connecter au wiki en utilisant la procédure interactive.

La procédure générale pour utiliser ce module est la suivante :

  1. Récupérer les champs disponibles avec action=query&meta=authmanagerinfo avec amirequestsfor=login, ainsi qu’un jeton login avec action=query&meta=tokens.
  2. Présenter les champs à l’utilisateur et faites-les lui soumettre.
  3. Effectuez l’envoi à ce module, en fournissant loginreturnurl et les champs appropriés.
  4. Vérifiez la valeur du champ status (état) dans la réponse.
    • Si vous avez reçu PASS (réussite) ou FAIL (échec), c’est terminé ; l’opération a soit réussi, soit échoué.
    • Si vous avez reçu UI (interface utilisateur), affichez les nouveaux champs à l’utilisateur et faites-les lui soumettre ; puis effectuez leur envoi à ce module avec logincontinue et l’ensemble des champs appropriés et reprenez à l’étape 4.
    • Si vous avez reçu REDIRECT (redirection), dirigez l’utilisateur vers la cible indiquée dans le champ redirecttarget et attendez son retour à loginreturnurl ; puis effectuez l’envoi à ce module avec logincontinue et tous les champs passés à l’URL de retour et reprenez à l’étape 4.
    • Si vous avez reçu RESTART (redémarrer), cela veut dire que l’authentification a fonctionné, mais nous n’avons aucun compte utilisateur lié ; vous pouvez traiter cela comme une valeur UI (interface utilisateur) ou FAIL (échec).
Paramètres :
loginrequests

Utiliser uniquement ces requêtes d’authentification, avec l’id renvoyé par action=query&meta=authmanagerinfo avec amirequestsfor=login ou depuis une réponse précédente de ce module.

Valeurs séparées par | ou autre.
Le nombre maximal de valeurs est 50 (ou 500 pour les clients ayant droit aux limites plus élevées).
loginmessageformat

Format à utiliser pour retourner les messages.

Une des valeurs suivantes : html, none, raw, wikitext
Par défaut : wikitext
loginmergerequestfields

Fusionner dans un tableau le champ information de toutes les demandes d’authentification.

Type : booléen (détails)
loginpreservestate

Conserver l’état d’une précédente tentative de connexion qui a échoué, si possible.

Type : booléen (détails)
loginreturnurl

Renvoyer l’URL pour les flux d’authentification tiers, qui doit être absolue. Soit celle-ci, soit logincontinue est obligatoire.

À la réception d’une réponse REDIRECT (rédirection), vous ouvrirez typiquement un navigateur ou une vue web vers l’URL spécifiée dans le champ redirecttarget pour un flux d’authentification tiers. Une cela se termine, le tiers renverra le navigateur ou l’affichage web vers cette URL. Vous devez extraire toute requête et tous les paramètres POST de l’URL et les passer à ce module de l’API comme une requête avec logincontinue.

logincontinue

Cette requête est une continuation après une précédente réponse UI ou REDIRECT. Cela ou loginreturnurl est obligatoire.

Type : booléen (détails)
logintoken

Un jeton « login » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
*
Ce module accepte des paramètres supplémentaires selon les requêtes d’authentification disponibles. Utiliser action=query&meta=authmanagerinfo avec amirequestsfor=login (ou une réponse précédente de ce module, le cas échéant) pour déterminer les requêtes disponibles et les champs qu’elles utilisent.
Exemples :
Commencer le processus de connexion au wiki en tant qu’utilisateur Example avec le mot de passe ExamplePassword.
api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [ouvrir dans le bac à sable]
Continuer la connexion après avoir obtenu une réponse UI (interface utilisateur) pour l’authentification à deux facteurs, en fournissant un OATHToken valant 987654.
api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [ouvrir dans le bac à sable]