Aide de l’API de 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/API

action=options

(main | options)
  • 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+

Modifier les préférences de l’utilisateur courant.

Seules les options enregistrées dans le cœur ou dans l’une des extensions installées, ou les options avec des clés préfixées par userjs- (devant être utilisées dans les scripts utilisateur), peuvent être définies.

Paramètres :
reset

Réinitialise les préférences aux valeurs par défaut du site.

Type : booléen (détails)
resetkinds

Liste des types d’option à réinitialiser quand l’option reset est définie.

Valeurs (séparées par |) : registered, registered-multiselect, registered-checkmatrix, userjs, special, unused, all
Par défaut : all
change

Liste des modifications, au format nom=valeur (par ex. skin=vector). La valeur ne peut pas contenir de caractère barre verticale. Si aucune valeur n’est fournie (pas même un signe égal), par ex., nomoption|autreoption|…, l’option sera réinitialisée à sa valeur par défaut.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
optionname

Un nom d’option qui doit être fixé à la valeur fournie par optionvalue.

optionvalue

La valeur d’une option spécifiée par optionname peut contenir des caractères barre verticale.

token

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

Ce paramètre est obligatoire.
Exemples :
Réinitialiser toutes les préférences
api.php?action=options&reset=&token=123ABC
Modifier les préférences skin et hideminor.
api.php?action=options&change=skin=vector|hideminor=1&token=123ABC
Réinitialiser toutes les préférences, puis définir skin et nickname.
api.php?action=options&reset=&change=skin=monobook&optionname=nickname&optionvalue=[[User:Beau|Beau]]%20([[User_talk:Beau|talk]])&token=123ABC