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)
- 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 :
- Obtenir des données sur un ensemble de pages (dernière révision), en mettant les titres ou les ids de page.
- Obtenir les révisions d’une page donnée, en utilisant les titres ou les ids de page avec rvstart, rvend ou rvlimit.
- Obtenir des données sur un ensemble de révisions en donnant leurs IDs avec revids.
- 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
- rvdifftotextpst
Effectuer une transformation avant enregistrement sur le texte avant de le comparer. Valide uniquement quand c’est utilisé avec rvdifftotext.
- Type : booléen (détails)
- 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.
- 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 [ouvrir dans le bac à sable]
- 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 [ouvrir dans le bac à sable]
- 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 [ouvrir dans le bac à sable]
- 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 [ouvrir dans le bac à sable]
- 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 [ouvrir dans le bac à sable]
- 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 [ouvrir dans le bac à sable]