Aide de l’API de MediaWiki

Ceci est une page d’aide de l’API de MédiaWiki 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.

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 une clé préfixée 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.

resetkinds

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

2=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