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.
- id
 L'ID du blocage à modifier.
- Type: entier
 - user
 Utilisateur à bloquer.
- Type : utilisateur, parmi nom d’utilisateur, IP, Utilisateur temporaire, 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, y compris les modifications de compte temporaires).
- 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 actuellement bloqué par un seul blocage, remplace le blocage existant. Si l'utilisateur est bloqué plusieurs fois, cette opération échouera. Utilisez plutôt le paramètre id pour spécifier le blocage à remplacer.
- Type : booléen (détails)
 - newblock
 Ajouter un autre blocage même si l'utilisateur est déjà bloqué.
- 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)
 Les balises de modification à 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
 - 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]