Aide de l’API de 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/API

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+

Obtenir des informations sur la 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 rvstart, rvend ou rvlimit.
  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
Marques de la révision (mineure).
timestamp
L’horodatage de la révision.
user
L’utilisateur qui a fait la révision.
userid
L’ID de l’utilisateur créateur de la révision.
size
Longueur (en octets) de la révision.
sha1
Hachage SHA-1 (base 16) de la révision.
contentmodel
ID du modèle de contenu de la révision.
comment
Commentaire de l’utilisateur sur la révision.
parsedcomment
Commentaire analysé de l’utilisateur sur la révision.
content
Texte de la révision.
tags
Balises de la révision.
parsetree
L’arbre d’analyse XML du contenu de la révision (nécessite le modèle de contenu wikitext).
Valeurs (séparées par |) : ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree
Par défaut : ids|timestamp|flags|comment|user
rvlimit

Limiter le nombre de révisions retournées.

Utilisable uniquement avec une seule page (mode #2).
Pas plus de 500 autorisé (5 000 pour les robots).
Type : entier ou max
rvexpandtemplates

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

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

Générer l’arbre d’analyse XML pour le contenu de la révision (nécessite rvprop=content ; remplacé par rvprop=parsetree).

Type : booléen (détails)
rvparse

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

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

rvdifftotext

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

rvcontentformat

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

Une des valeurs suivantes : text/x-wiki, text/javascript, application/json, text/css, text/plain
rvstartid

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

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

Arrêter l’énumération des révisions à cet ID.

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 l’utilisateur.

Utilisable uniquement avec une seule page (mode #2).
Type : nom d’utilisateur
rvexcludeuser

Exclure les révisions faites par l’utilisateur.

Utilisable uniquement avec une seule page (mode #2).
Type : nom d’utilisateur
rvtag

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

rvtoken
Obsolète.

Quels jetons obtenir pour chaque révision.

Valeurs (séparées par |) : rollback
rvcontinue

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

Exemples :
Obtenir des données avec le contenu pour la dernière révision des titres API et Page principale.
api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content
Obtenir les 5 dernières révisions de la Main Page.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment
Obtenir les 5 premières révisions de la Page principale.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer
Obtenir les 5 premières révisions de la Page principale faites après le 01/05/2006.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z
Obtenir les 5 premières révisions de la Page principale qui n’ont pas été faites par l’utilisateur anonyme 127.0.0.1.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1
Obtenir les 5 premières révisions de la Page principale qui ont été faites par l’utilisateur MédiaWiki par défaut.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default