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=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-or-later
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.
- reset
Réinitialise les préférences avec les 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 | ou autre) : all, registered, registered-checkmatrix, registered-multiselect, special, unused, userjs
- Par défaut : all
- change
Liste des modifications, au format nom=valeur (par ex. skin=vector). 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. Pour toute valeur passée contenant une barre verticale (|), utiliser le séparateur alternatif de valeur multiple pour que l'opération soit correcte.
- Valeurs séparées par | ou autre.
- Le nombre maximal de valeurs est 50 (500 pour les clients ayant droit aux limites plus élevées).
- optionname
Nom de l’option qui doit être définie avec la valeur fournie par optionvalue.
- optionvalue
La valeur de l'option spécifiée par optionname.
- token
Un jeton « csrf » récupéré par action=query&meta=tokens
- Ce paramètre est obligatoire.
- Réinitialiser toutes les préférences
- api.php?action=options&reset=&token=123ABC [ouvrir dans le bac à sable]
- Modifier les préférences skin et hideminor.
- api.php?action=options&change=skin=vector|hideminor=1&token=123ABC [ouvrir dans le bac à sable]
- 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 [ouvrir dans le bac à sable]