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

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

Créer et modifier des pages.

Paramètres :
D'autres paramètres généraux sont disponibles.
title

Titre de la page que vous voulez modifier. Impossible de l’utiliser avec pageid.

pageid

Identifiant de la page que vous voulez modifier. Incompatible avec title.

Type: entier
section

Identifiant de section. 0 pour la section de tête, new pour une nouvelle section. C’est souvent un entier positif, mais il peut également être non numérique.

sectiontitle

Le titre pour une nouvelle section en utilisant section=new.

text

Contenu de la page.

summary

Résumé de modification.

Quand ce paramètre n’est pas fourni ou vide, un résumé de modification peut être généré automatiquement.

En utilisant section=new et si sectiontitle n’est pas fourni, la valeur de ce paramètre est utilisée à la place pour le titre de la section et un résumé de modification est généré automatiquement.

tags

Modifier les balises à appliquer à la version.

Valeurs (séparées par | ou autre) :
minor

Marquer cette modification comme étant mineure.

Type : booléen (détails)
notminor

Ne pas marquer cette modification comme mineure, même si la préférence utilisateur « Marquer toutes mes modifications comme étant mineures par défaut » est positionnée.

Type : booléen (détails)
bot

Marquer cette modification comme effectuée par un robot.

Type : booléen (détails)
baserevid

Identifiant de la version de base, utilisé pour détecter les conflits de modification. Peut être obtenu via action=query&prop=revisions. Les conflits entre des modifications d’un même utilisateur provoquent l’échec de la modification à moins que « basetimestamp » soit défini.

Type: entier
basetimestamp

Horodatage de la version de base, utilisé pour détecter les conflits de modification. Peut être obtenu via action=query&prop=revisions&rvprop=timestamp. Les conflits entre des modifications d’un même utilisateur sont ignorés.

Type : horodatage (formats autorisés)
starttimestamp

L’horodatage, lorsque le processus de modification a commencé, est utilisé pour détecter les conflits de modification. Une valeur appropriée peut être obtenue en utilisant curtimestamp au début de ce processus (par ex. en chargeant le contenu de la page à modifier).

Type : horodatage (formats autorisés)
recreate

Ignorer toutes les erreurs concernant la page qui a été supprimée entre temps.

Type : booléen (détails)
createonly

Ne pas modifier la page si elle existe déjà.

Type : booléen (détails)
nocreate

Lever une erreur si la page n’existe pas.

Type : booléen (détails)
watch
Obsolète.

Ajouter la page à la liste de suivi de l’utilisateur actuel.

Type : booléen (détails)
unwatch
Obsolète.

Supprimer la page de la liste de suivi de l’utilisateur actuel.

Type : booléen (détails)
watchlist

Ajouter ou supprimer sans condition la page de votre liste de suivi, utiliser les préférences (ignorer pour les robots) ou ne pas changer le suivi.

Une des valeurs suivantes : nochange, preferences, unwatch, watch
Par défaut : preferences
md5

Le hachage MD5 du paramètre text, ou bien les paramètres prependtext et appendtext concaténés. Si défini, la modification ne sera pas effectuée à moins que le hachage soit correct.

prependtext

Ajouter ce texte au début de la page ou de la section. A priorité sur text.

appendtext

Ajouter ce texte à la fin de la page ou de la section. A priorité sur text.

Utiliser section=new pour ajouter une nouvelle section, plutôt que ce paramètre.

undo

Annuler cette version. Écrase text, prependtext et appendtext.

Type: entier
La valeur ne peut pas être inférieure à 0.
undoafter

Annuler toutes les versions depuis undo jusqu’à celle-ci. Si non défini, annuler uniquement une version.

Type: entier
La valeur ne peut pas être inférieure à 0.
redirect

Résoudre automatiquement les redirections.

Type : booléen (détails)
contentformat

Format de sérialisation du contenu utilisé pour le texte d’entrée.

Une des valeurs suivantes : application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
contentmodel

Modèle de contenu du nouveau contenu.

Une des valeurs suivantes : GadgetDefinition, css, javascript, json, text, unknown, wikitext
returnto

Titre de la page. Si l’enregistrement de la modification a créé un compte temporaire, l’API peut répondre avec un URL que le client doit visiter pour terminer son enregistrement. Si ce paramètre est fourni, l’URL redirigera vers la page indiquée au lieu de la page qui a été modifiée.

Type : titre de page
Accepte les pages inexistantes.
returntoquery

Paramètres de requête de l’URL (avec ? devant). Si l’enregistrement de la modification a créé un compte temporaire, l’API peut répondre avec un URL que le client doit visiter pour terminer son enregistrement. Si ce paramètre est fourni, l’URL redirigera vers une page avec les paramètres de requête indiqués.

Par défaut : (vide)
returntoanchor

Fragment d’URL (avec # devant). Si l’enregistrement de la modification a créé un compte temporaire, l’API peut répondre avec un URL que le client doit visiter pour terminer son enregistrement. Si ce paramètre est fourni, l’URL redirigera vers une page avec le fragment indiqué.

Par défaut : (vide)
token

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

Le jeton doit toujours être envoyé en tant que dernier paramètre, ou au moins après le paramètre text.

Ce paramètre est obligatoire.