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=createaccount (create)
- Ce module nécessite des droits d’écriture.
- Ce module n’accepte que les requêtes POST.
- Source : MediaWiki
- Licence : GPL-2.0-or-later
Créer un nouveau compte utilisateur.
La procédure générale pour utiliser ce module est la suivante :
- Récupérer les champs disponibles avec action=query&meta=authmanagerinfo avec amirequestsfor=create, et un jeton createaccount avec action=query&meta=tokens.
- Présenter les champs à l’utilisateur, et les lui faire soumettre.
- Faire un envoi à ce module, en fournissant createreturnurl et les champs appropriés.
- Vérifier le status dans la réponse.
- Si vous avez reçu PASS ou FAIL, c’est terminé. L’opération a soit réussi, soit échoué.
- Si vous avez reçu UI, affichez les nouveaux champs à l’utilisateur et faites-les-lui soumettre. Puis envoyez-les à ce module avec createcontinue et l’ensemble des champs appropriés, et recommencez l’étape 4.
- Si vous avez reçu REDIRECT, envoyez l’utilisateur vers la cible redirecttarget et attendez le retour vers createreturnurl. Puis envoyez à ce module avec createcontinue et tous les champs passés à l’URL de retour, puis répétez l’étape 4.
- Si vous avez reçu RESTART, cela veut dire que l’authentification a fonctionné, mais nous n’avons pas de compte utilisateur lié. Vous pouvez traiter cela comme un UI ou un FAIL.
- createrequests
Utiliser uniquement ces requêtes d’authentification, avec l’id renvoyé par action=query&meta=authmanagerinfo avec amirequestsfor=create 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 (500 pour les clients ayant droit aux limites plus élevées).
- createmessageformat
Format à utiliser pour retourner les messages.
- Une des valeurs suivantes : html, none, raw, wikitext
- Par défaut : wikitext
- createmergerequestfields
Fusionner dans un tableau le champ information de toutes les demandes d’authentification.
- Type : booléen (détails)
- createpreservestate
Conserver l’état d’une précédente tentative de connexion qui a échoué, si possible.
Si action=query&meta=authmanagerinfo a retourné true pour hasprimarypreservedstate, les demandes marquées comme primary-required doivent être omises. Si elle a retourné une valeur non vide pour preservedusername, ce nom d’utilisateur doit être utilisé pour le paramètre username.
- Type : booléen (détails)
- createreturnurl
Renvoyer l’URL pour les flux d’authentification tiers, qui doit être absolue. Cela ou createcontinue est obligatoire.
Dès réception d’une réponse REDIRECT, vous ouvrirez typiquement un navigateur ou un affichage web vers l’URL redirecttarget spécifiée pour un flux d’authentification tiers. Une fois ceci terminé, le tiers renverra le navigateur ou l’affichage web vers cette URL. Vous devez extraire toute requête ou paramètre POST de l’URL et les passer comme une requête createcontinue à ce module de l’API.
- createcontinue
Cette requête est une continuation après une précédente réponse UI ou REDIRECT. Cela ou createreturnurl est obligatoire.
- Type : booléen (détails)
- createtoken
Un jeton « createaccount » 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=create (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.
- Commencer le processus de création de l’utilisateur Exemple avec le mot de passe ExempleMotDePasse.
- api.php?action=createaccount&username=Example&password=ExamplePassword&retype=ExamplePassword&createreturnurl=http://example.org/&createtoken=123ABC [ouvrir dans le bac à sable]