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
- 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.
- 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, 828, 829, 2300, 2301, 2302, 2303, 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.
- 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]