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=deletedrevisions (drv)
- 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 supprimée.
Peut être utilisé de différentes manières :
- obtenir les versions supprimées pour un ensemble de pages, défini par des titres ou des identifiants de page (liste ordonnée par titre et horodatage) ;
- obtenir les données sur un ensemble de versions supprimées, défini par leurs identifiants avec leurs identifiants de version (liste ordonnée par identifiant de version).
- drvprop
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 slot de révision. Si le contenu a été supprimé par révision, une propriété texthidden sera renvoyée. Pour des raisons de performances, si cette option est utilisée, drvlimit est appliquée à 50 .
- tags
- Balises de la révision.
- roles
- Lister les rôles d’emplacement de contenu qui existent dans la version.
- parsetree
- Obsolète. Utilisez plutôt action=expandtemplates ou action=parse. L’arborescence d’analyse XML du contenu des révisions (nécessite le modèle de contenu
wikitext). Pour des raisons de performances, si cette option est utilisée, drvlimit est appliquée à 50.
- 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
- drvslots
Pour quels emplacements de version renvoyer des données, quand les propriétés relatives aux emplacements sont incluses dans drvprops. 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 *.
- drvcontentformat-{slot}
Format de sérialisation du contenu utilisé pour la sortie du contenu.
- Ceci est un paramètre de modèle. En faisant une requête, {slot} dans le nom du paramètre doit être remplacé par des valeurs de drvslots.
- 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
- drvlimit
Limitez le nombre de révisions qui seront renvoyées. Si drvprop=content , drvprop=parsetree , drvdiffto ou drv difftotext est utilisé, la limite est 50 . Si drvparse est utilisée, la limite est 1 .
- Type : entier ou max
- La valeur doit être entre 1 et 500.
- drvexpandtemplates
- Obsolète.
Utiliser action=expandtemplates à la place. Développer les modèles dans le contenu de la révision (nécessite drvprop=content).
- Type : booléen (détails)
- drvgeneratexml
- 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 drvprop=content).
- Type : booléen (détails)
- drvparse
- Obsolète.
Utiliser action=parse à la place. Analyser le contenu de la révision (nécessite drvprop=content). Pour des raisons de performance, si cette option est utilisée, drvlimit est forcé à 1.
- Type : booléen (détails)
- drvsection
Récupérer seulement le contenu de la section ayant cet identifiant.
- drvdiffto
- 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. Pour des raisons de performance, si cette option est utilisée, drvlimit est forcé à 50.
- drvdifftotext
- Obsolète.
Utiliser action=compare à la place. Texte auquel comparer chaque révision. Compare uniquement un nombre limité de révisions. Écrase drvdiffto. Si drvsection est positionné, seule cette section sera comparée avec ce texte. Pour des raisons de performance, si cette option est utilisée, drvlimit est forcé à 50.
- drvdifftotextpst
- Obsolète.
Utiliser action=compare à la place. Effectuer une transformation avant enregistrement sur le texte avant de le comparer. Valide uniquement quand utilisé avec drvdifftotext.
- Type : booléen (détails)
- drvcontentformat
- Obsolète.
Format de sérialisation utilisé pour drvdifftotext 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
- drvstart
L’horodatage auquel commencer l’énumération. Ignoré lors du traitement d’une liste d’identifiants de versions.
- Type : horodatage (formats autorisés)
- drvend
L’horodatage auquel arrêter l’énumération. Ignoré lors du traitement d’une liste d’identifiants de versions.
- Type : horodatage (formats autorisés)
- drvdir
Dans quelle direction énumérer :
- newer
- lister les plus anciens en premier ; note : drvstart doit être antérieur à drvend.
- older
- lister les plus récents en premier (par défaut) ; note : drvstart doit être postérieur à drvend.
- Une des valeurs suivantes : newer, older
- Par défaut : older
- drvtag
Lister uniquement les versions marquées par cette balise.
- drvuser
Lister uniquement les versions réalisées par cet utilisateur.
- Type : utilisateur, parmi nom d’utilisateur, IP, Utilisateur temporaire, nom interwiki (par ex. « préfixe>NomParExemple ») et identifiant de l’utilisateur (par ex. « #12345 »)
- drvexcludeuser
Ne pas lister les versions réalisées par cet utilisateur.
- Type : utilisateur, parmi nom d’utilisateur, IP, Utilisateur temporaire, nom interwiki (par ex. « préfixe>NomParExemple ») et identifiant de l’utilisateur (par ex. « #12345 »)
- drvcontinue
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.
- Lister les informations pour la version supprimée 123456.
- api.php?action=query&prop=deletedrevisions&revids=123456 [ouvrir dans le bac à sable]
- Lister les révisions supprimées de la page Accueil et de sa page de discussion, avec leur contenu.
- api.php?action=query&prop=deletedrevisions&titles=Accueil|Discussion%3AAccueil&drvslots=*&drvprop=user|comment|content [ouvrir dans le bac à sable]