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 les informations sur une version.

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

  1. obtenir les données sur un ensemble de pages (dernière version), en indiquant les titres ou les identifiants de page ;
  2. obtenir les versions d’une page donnée, en indiquant les titres ou les identifiants de page avec un horodatage de début ou de fin ou une limite en nombre ;
  3. obtenir des données sur un ensemble de versions en indiquant leurs identifiants identifiants de version.
Paramètres :
D'autres paramètres généraux sont disponibles.
rvprop

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

ids
L’identifiant de la révision.
flags
Attributs de la révision (mineure).
timestamp
L’horodatage de la révision.
user
L’utilisateur qui a réalisé la version. Si l’utilisateur a été supprimé d’une version, une propriété userhidden (utilisateur masqué) 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 (SHA1 masqué) sera retournée.
contentmodel
Identifiant du modèle de contenu de chaque créneau 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 (texte masqué) sera retournée.
tags
Balises de la révision.
roles
Lister les rôles d’emplacement de contenu qui existent dans la version.
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 version 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 (principal) 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 seulement le contenu de la section ayant cet identifiant.

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 version. La version doit exister mais il n’est pas nécessaire que ce soit une version de cette page.

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

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

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

À quel horodatage de version commencer 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 antérieur à rvend.
older
lister les plus récents 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 versions réalisées 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 identifiant de l’utilisateur (par ex. « #12345 »)
rvexcludeuser

Exclure les versions réalisées 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 identifiant de l’utilisateur (par ex. « #12345 »)
rvtag

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

rvcontinue

Quand plus de résultats sont disponibles, utilisez ceci pour continuer. Des informations plus détaillées sur la façon de continuer les requêtes peuvent être trouvées sur mediawiki.org.

Exemples :
Obtenir des données pour la dernière révision des titres API et Le wiki de Fab Labs Québec.
api.php?action=query&prop=revisions&titles=API|Le%20wiki%20de%20Fab%20Labs%20Qu%C3%A9bec&rvslots=*&rvprop=timestamp|user|comment|content [ouvrir dans le bac à sable]
Obtenir les 5 dernières révisions de Le wiki de Fab Labs Québec.
api.php?action=query&prop=revisions&titles=Le%20wiki%20de%20Fab%20Labs%20Qu%C3%A9bec&rvlimit=5&rvprop=timestamp|user|comment [ouvrir dans le bac à sable]
Obtenir les 5 premières révisions de Le wiki de Fab Labs Québec.
api.php?action=query&prop=revisions&titles=Le%20wiki%20de%20Fab%20Labs%20Qu%C3%A9bec&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [ouvrir dans le bac à sable]
Obtenir les 5 premières versions de Le wiki de Fab Labs Québec réalisées après le 01/05/2006.
api.php?action=query&prop=revisions&titles=Le%20wiki%20de%20Fab%20Labs%20Qu%C3%A9bec&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [ouvrir dans le bac à sable]
Obtenir les 5 premières versions de Le wiki de Fab Labs Québec qui n’ont pas été réalisées par un utilisateur anonyme 127.0.0.1.
api.php?action=query&prop=revisions&titles=Le%20wiki%20de%20Fab%20Labs%20Qu%C3%A9bec&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [ouvrir dans le bac à sable]
Obtenir les 5 premières versions de Le wiki de Fab Labs Québec qui ont été réalisées par l’utilisateur MediaWiki default.
api.php?action=query&prop=revisions&titles=Le%20wiki%20de%20Fab%20Labs%20Qu%C3%A9bec&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [ouvrir dans le bac à sable]