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

(main | block)
  • Ce module nécessite des droits de lecture.
  • 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

Bloquer un utilisateur.

Paramètres :
user

Utilisateur à bloquer.

Type : utilisateur, par un des nom d’utilisateur, IP, plage d’adresses IP et ID utilisateur (par ex. « #12345 »)
userid
Obsolète.

Spécifier plutôt user=#ID.

Type: entier
expiry

Durée d’expiration (exprimée en anglais). Peut être relative (par ex. 5 months ou 2 weeks) ou absolue (par ex. 2014-09-18T12:34:56Z). Si elle est indiquée comme infinite, indefinite ou never, le blocage n’expirera jamais.

Par défaut : never
reason

Motif du blocage.

Par défaut : (vide)
anononly

Bloquer uniquement les utilisateurs anonymes (c’est-à-dire désactiver les modifications anonymes pour cette adresse IP).

Type : booléen (détails)
nocreate

Empêcher la création de compte.

Type : booléen (détails)
autoblock

Bloquer automatiquement la dernière adresse IP utilisée et toute les adresses IP subséquentes depuis lesquelles ils ont essayé de se connecter.

Type : booléen (détails)
noemail

Empêcher l’utilisateur d’envoyer des courriels via le wiki (nécessite le droit blockemail).

Type : booléen (détails)
hidename

Masque le nom de l’utilisateur dans le journal des blocages (nécessite le droit hideuser).

Type : booléen (détails)
allowusertalk

Autoriser les utilisateurs à modifier leur propre page de discussion (dépend de $wgBlockAllowsUTEdit).

Type : booléen (détails)
reblock

Si l’utilisateur est déjà bloqué, écraser le blocage existant.

Type : booléen (détails)
watchuser

Surveiller les pages utilisateur et de discussion de l’utilisateur ou de l’adresse IP.

Type : booléen (détails)
tags

Modifier les balises à appliquer à l’entrée du journal des blocages.

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

Bloquer un utilisateur pour des pages ou des espaces de nom spécifiques plutôt que pour tout un site.

Type : booléen (détails)
pagerestrictions

Liste des titres pour lesquels bloquer l’utilisateur en modification. Ne s’applique que quand partial est mis à vrai.

Valeurs séparées par | ou autre.
Le nombre maximal de valeurs est 10.
namespacerestrictions

Liste d’ID d’espaces de noms sur lesquels l’utilisateur est bloqué en modification. Ne s’applique que quand partial vaut vrai.

Valeurs (séparées par | ou autre) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 200, 201, 202, 203
Pour spécifier toutes les valeurs, utiliser *.
token

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

Ce paramètre est obligatoire.
Exemples :
Bloquer l’adresse IP 192.0.2.5 pour trois jours avec un motif indiqué.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [ouvrir dans le bac à sable]
Bloquer indéfiniment l’utilisateur Vandal avec le motif indiqué et empêcher la création de nouveau compte et l’envoi de courriel.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [ouvrir dans le bac à sable]