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 accepte seulement les requêtes POST.
  • Source : MediaWiki
  • Licence : GPL-2.0-or-later

Bloquer un utilisateur.

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

Utilisateur à bloquer.

Type : utilisateur, parmi nom d’utilisateur, IP, plage d’adresses IP et identifiant de l’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 positionné à vrai.

Type : titre de page
Valeurs séparées par | ou autre.
Le nombre maximal de valeurs est 10.
Accepte uniquement les pages qui existent.
namespacerestrictions

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

Valeurs (séparées par | ou autre) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 102, 103, 106, 107, 108, 109, 112, 113, 114, 115, 420, 421, 460, 461, 828, 829, 3000, 3001
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]