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 n’accepte que 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 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.
- 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’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, 2300, 2301, 2302, 2303
- 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]