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=userrights

(main | userrights)
  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module accepte seulement les requêtes POST.
  • Source : MediaWiki
  • Licence : GPL-2.0-or-later

Modifier l’appartenance d’un utilisateur à un groupe.

Paramètres :
D'autres paramètres généraux sont disponibles.
user

Utilisateur.

Type : utilisateur, parmi nom d’utilisateur et identifiant de l’utilisateur (par ex. « #12345 »)
userid
Obsolète.

Spécifier plutôt user=#ID.

Type: entier
add

Ajouter les utilisateurs à ces groupes, ou s’ils sont déjà membres, mettre à jour la date d’expiration de leur appartenance à ce groupe.

Valeurs (séparées par | ou autre) : bot, bureaucrat, interface-admin, lelierre, suppress, sysop
expiry

Horodatages d’expiration. Peuvent être relatifs (par ex. 5 mois ou 2 semaines) ou absolus (par ex. 2014-09-18T12:34:56Z). Si uniquement un horodatage est fixé, il sera utilisé pour tous les groupes passés au paramètre add. Utiliser infinite, indefinite, infinity, ou never pour un lien de groupe d'utilisateurs qui n’expire jamais.

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).
Par défaut : infinite
remove

Supprimer l’utilisateur de ces groupes.

Valeurs (séparées par | ou autre) : bot, bureaucrat, interface-admin, lelierre, suppress, sysop
reason

Motif de la modification.

Par défaut : (vide)
token

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

Pour rester compatible, le jeton utilisé dans l’IHM web est aussi accepté.

Ce paramètre est obligatoire.
tags

Modifier les balises à appliquer à l’entrée dans le journal des droits utilisateur.

Valeurs (séparées par | ou autre) :
watchuser

Surveiller les pages utilisateur et discussion de l’utilisateur.

Type : booléen (détails)
Exemples :
Ajouter l’utilisateur FooBot au groupe bot et le supprimer des groupes sysop et bureaucrat.
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC [ouvrir dans le bac à sable]
Ajouter l’utilisateur d’ID 123 au groupe bot, et le supprimer des groupes sysop et bureaucrat.
api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC [ouvrir dans le bac à sable]
Ajouter l'utilisateur SometimeSysop au groupe sysop pour 1 mois.
api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [ouvrir dans le bac à sable]