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
- 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.
- 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. 
- Les balises de modification à 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 : Scribunto, css, javascript, json, text, unknown, wikitext
- 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.
- 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)
- Modifier une page
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [ouvrir dans le bac à sable]
- Préfixer une page par __NOTOC__.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [ouvrir dans le bac à sable]
- Annuler les versions 13579 à 13585 avec un résumé automatique.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [ouvrir dans le bac à sable]