API aide 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-or-later
Récupèrer les informations de relecture.
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 un début, une fin, ou une limite.
- 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.
- slotsize
- Longueur (en octets) de chaque emplacement de révision.
- sha1
- Hachage SHA-1 (base 16) de la révision.
- slotsha1
- SHA-1 (base 16) de chaque emplacement de révision.
- contentmodel
- ID du modèle de contenu de chaque emplacement de révision.
- comment
- Commentaire de l’utilisateur sur la révision.
- parsedcomment
- Commentaire analysé de l’utilisateur sur la révision.
- content
- Contenu de chaque emplacement de révision.
- tags
- Balises de la révision.
- roles
- Lister les rôles d’emplacement de contenu qui existent dans la révision.
- parsetree
- Désuet. 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) : ids, flags, timestamp, user, userid, size, slotsize, sha1, slotsha1, contentmodel, comment, parsedcomment, content, tags, roles, 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 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ésuet.
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
- Désuet.
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
- Désuet.
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
- Désuet.
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
- Désuet.
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
- Désuet.
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
- Désuet.
Format de sérialisation utilisé pour rvdifftotext et attendu pour la sortie du contenu.
- Une des valeurs suivantes : application/json, text/x-wiki, text/javascript, text/css, text/plain
- rvstartid
Commencer l'énumération à partir de la date de cette revue. La revue doit exister, mais ne concerne pas forcément cette page.
- Utilisable uniquement avec une seule page (mode #2).
- Type : entier
- rvendid
Arrêter l’énumération à la date de cette revue. La revue doit exister mais ne concerne pas forcément 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 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
- Désuet.
Quels jetons obtenir pour chaque révision.
- Valeurs (séparées par | ou autre) : 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 Main Page.
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&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]