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)
- 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 :
- 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
- 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.
- Obtenir des données pour la dernière révision des titres API et Main Page, y compris le contenu.
- 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 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 Main Page.
- 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 Main Page 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 Main Page 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 Main Page qui ont été faites par lâutilisateur MediaWiki default.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [ouvrir dans le bac à sable]