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

prop=revisions (rv)

(main | query | revisions)
  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.
  • Source : MediaWiki
  • Licence : GPL-2.0-or-later

Obtenir des informations sur une révision.

Peut être utilisé de différentes manières :

  1. Obtenir des données sur un ensemble de pages (dernière révision), en mettant les titres ou les ids de page.
  2. Obtenir les révisions d’une page donnée, en utilisant les titres ou les ids de page avec un début, une fin ou une limite.
  3. Obtenir des données sur un ensemble de révisions en donnant leurs IDs avec revids.
Paramètres :
rvprop

Quelles propriétés obtenir pour chaque révision :

ids
L’ID de la révision.
flags
Attributs de la révision (mineure).
timestamp
L’horodatage de la révision.
user
L’utilisateur qui a fait la révision. Si l’utilisateur a été supprimé d’une version, une propriété userhidden sera retournée.
userid
L’ID de l’utilisateur créateur de la version. Si l'utilisateur a été supprimé d’une version, une propriété userhidden sera retournée.
size
Longueur (en octets) de la révision.
slotsize
Longueur (en octets) de chaque emplacement de révision.
sha1
Hachage SHA-1 (en hexadécimal) de la version. Si le contenu a été supprimé d’une version, une propriété sha1hidden sera retournée.
slotsha1
Hachage SHA-1 (en hexadécimal) de chaque emplacement de version. Si le contenu a été supprimé d’une version, une propriété sha1hidden sera retournée.
contentmodel
ID du modèle de contenu de chaque emplacement de révision.
comment
Commentaire de l’utilisateur pour la version. Si le commentaire a été supprimé d’une version, une propriété commenthidden sera retournée.
parsedcomment
Commentaire analysé de l’utilisateur sur la version. Si le commentaire a été supprimé d’une version, une propriété commenthidden sera retournée.
content
Contenu de chaque emplacement de version. Si le contenu a été supprimé d’une version, une propriété texthidden sera retournée.
tags
Balises de la révision.
roles
Lister les rôles d’emplacement de contenu qui existent dans la révision.
parsetree
Obsolète. Utiliser action=expandtemplates ou action=parse à la place. L’arbre d’analyse XML du contenu de la révision (nécessite le modèle de contenu wikitext).
Valeurs (séparées par | ou autre) : comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
Par défaut : ids|timestamp|flags|comment|user
rvslots

Pour quels emplacements de révision renvoyer des données, quand les propriétés relatives aux emplacements sont incluses dans rvprops. Si omis, les données de l’emplacement main seront renvoyées dans un format rétro-compatible.

Valeurs (séparées par | ou autre) : main
Pour spécifier toutes les valeurs, utiliser *.
rvlimit

Limiter le nombre de révisions renvoyées.

Utilisable uniquement avec une seule page (mode #2).
Type : entier ou max
La valeur doit être entre 1 et 500.
rvexpandtemplates
Obsolète.

Utiliser action=expandtemplates à la place. Développer les modèles dans le contenu de la révision (nécessite rvprop=content).

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

Utiliser action=expandtemplates ou action=parse à la place. Générer l’arbre d’analyse XML pour le contenu de la révision (nécessite rvprop=content).

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

Utiliser action=parse à la place. Analyser le contenu de la révision (nécessite rvprop=content). Pour des raisons de performance, si cette option est utilisée, rvlimit est forcé à 1.

Type : booléen (détails)
rvsection

Récupérer uniquement le contenu de ce numéro de section.

rvdiffto
Obsolète.

Utiliser action=compare à la place. ID de révision à prendre pour comparer chaque révision. Utiliser prev, next et cur pour la version précédente, suivante et actuelle respectivement.

rvdifftotext
Obsolète.

Utiliser action=compare à la place. Texte auquel comparer chaque révision. Compare uniquement un nombre limité de révisions. Écrase rvdiffto. Si rvsection est positionné, seule cette section sera comparée avec ce texte.

rvdifftotextpst
Obsolète.

Utiliser action=compare à la place. Effectuer une transformation avant enregistrement sur le texte avant de le comparer. Valide uniquement quand utilisé avec rvdifftotext.

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

Format de sérialisation utilisé pour rvdifftotext et attendu pour la sortie du contenu.

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
rvstartid

Commencer l’énumération à partir de la date de cette révision. La révision doit exister mais il n’est pas nécessaire que ce soit une révision de cette page.

Utilisable uniquement avec une seule page (mode #2).
Type: entier
rvendid

Arrêter l’énumération à la date de cette révision. La révision doit exister mais il n’est pas nécessaire que ce soit une révision de cette page.

Utilisable uniquement avec une seule page (mode #2).
Type: entier
rvstart

À quel horodatage de révision démarrer l’énumération.

Utilisable uniquement avec une seule page (mode #2).
Type : horodatage (formats autorisés)
rvend

Énumérer jusqu’à cet horodatage.

Utilisable uniquement avec une seule page (mode #2).
Type : horodatage (formats autorisés)
rvdir

Dans quelle direction énumérer :

newer
lister les plus anciens en premier. Note : rvstart doit être avant rvend.
older
lister les nouveaux en premier (par défaut). Note : rvstart doit être postérieur à rvend.
Utilisable uniquement avec une seule page (mode #2).
Une des valeurs suivantes : newer, older
Par défaut : older
rvuser

Inclure uniquement les révisions faites par un utilisateur donné.

Utilisable uniquement avec une seule page (mode #2).
Type : utilisateur, parmi nom d’utilisateur, IP, nom interwiki (par ex. « préfixe>NomParExemple ») et ID utilisateur (par ex. « #12345 »)
rvexcludeuser

Exclure les révisions faites par un utilisateur donné.

Utilisable uniquement avec une seule page (mode #2).
Type : utilisateur, parmi nom d’utilisateur, IP, nom interwiki (par ex. « préfixe>NomParExemple ») et ID utilisateur (par ex. « #12345 »)
rvtag

Lister uniquement les révisions marquées avec cette balise.

rvcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.