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.
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.
- 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]