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=linkaccount (link)
- 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
Lier un compte dâun fournisseur tiers à lâutilisateur actuel.
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=link, et un jeton csrf avec action=query&meta=tokens.
- Présenter les champs à lâutilisateur, et les lui faire soumettre.
- Faire un envoi à ce module, en fournissant linkreturnurl 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 linkcontinue 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 linkreturnurl. Puis envoyez à ce module avec linkcontinue 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.
- linkrequests
Utiliser uniquement ces requêtes dâauthentification, avec lâid renvoyé par action=query&meta=authmanagerinfo avec amirequestsfor=link 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).
- linkmessageformat
Format à utiliser pour retourner les messages.
- Une des valeurs suivantesâ¯: html, none, raw, wikitext
- Par défaut : wikitext
- linkmergerequestfields
Fusionner dans un tableau le champ information de toutes les demandes dâauthentification.
- Type : booléen (détails)
- linkreturnurl
Renvoyer lâURL pour les flux dâauthentification tiers, qui doit être absolue. Cela ou linkcontinue 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 linkcontinue à ce module de lâAPI.
- linkcontinue
Cette requête est une continuation après une précédente réponse UI ou REDIRECT. Cela ou linkreturnurl est obligatoire.
- Type : booléen (détails)
- linktoken
Un jeton « csrf » 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=link (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 liaison dâun compte depuis Exemple.
- api.php?action=linkaccount&provider=Example&linkreturnurl=http://example.org/&linktoken=123ABC [ouvrir dans le bac à sable]