Aide de l’API de MediaWiki

Ceci est une page d’aide de l’API de MédiaWiki générée automatiquement.

Documentation et exemples : https://www.mediawiki.org/wiki/API

Module principal

État : Toutes les fonctionnalités affichées sur cette page devraient fonctionner, mais l’API est encore en cours de développement et peut changer à tout moment. Inscrivez-vous à la liste de diffusion mediawiki-api-announce pour être informé des mises à jour.

Requêtes erronées : Si des requêtes erronées sont envoyées à l’API, un en-tête HTTP sera renvoyé avec la clé « MediaWiki-API-Error ». La valeur de cet en-tête et le code d’erreur renvoyé prendront la même valeur. Pour plus d’information, voyez API: Errors and warnings.

Paramètres :
action

Quelle action effectuer.

Une valeur : block, checktoken, clearhasmsg, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, login, logout, managetags, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, revisiondelete, rollback, rsd, setnotificationtimestamp, stashedit, tag, tokens, unblock, undelete, upload, userrights, watch
Par défaut : help
format

Le format de sortie.

Une valeur : dbg, dbgfm, dump, dumpfm, json, jsonfm, none, php, phpfm, rawfm, txt, txtfm, wddx, wddxfm, xml, xmlfm, yaml, yamlfm
Par défaut : jsonfm
maxlag

La latence maximale peut être utilisée quand MédiaWiki est installé sur un cluster de base de données répliqué. Pour éviter des actions provoquant un supplément de latence de réplication de site, ce paramètre peut faire attendre le client jusqu’à ce que la latence de réplication soit inférieure à une valeur spécifiée. En cas de latence excessive, le code d’erreur maxlag est renvoyé avec un message tel que Attente de $host : $lag secondes de délai.
Voyez Manuel: Maxlag parameter pour plus d’information.

smaxage

Fixer l’entête s-maxage à ce nombre de secondes. Les erreurs ne sont jamais mises en cache.

Par défaut : 0
maxage

Fixer l’entête max-age à ce nombre de secondes. Les erreurs ne sont jamais mises en cache.

Par défaut : 0
assert

Vérifier si l’utilisateur est connecté si positionné à user, ou a le droit utilisateur robot si positionné à bot.

Une valeur : user, bot
requestid

Toute valeur fournie ici sera incluse dans la réponse. Peut être utilisé pour distinguer des demandes.

servedby

Inclure le nom d’hôte qui a renvoyé la requête dans les résultats.

curtimestamp

Inclure l’horodatage actuel dans le résultat.

origin

En accédant à l’API en utilisant une requête AJAX inter-domaines (CORS), mettre le domaine d’origine dans ce paramètre. Il doit être inclus dans toute requête de pre-flight, et doit donc faire partie de l’URI de la requête (pas du corps du POST). Il doit correspondre exactement à une des origines dans l’entête Origin header, donc il doit être fixé avec quelque chose comme https://en.wikipedia.org ou https://meta.wikimedia.org. Si ce paramètre ne correspond pas à l’entête Origin, une réponse 403 sera renvoyée. Si ce paramètre correspond à l’entête Origin et que l’origine est en liste blanche, un entête Access-Control-Allow-Origin sera positionné.

uselang

Langue à utiliser pour les traductions de message. Une liste de codes peut être analysée depuis action=query&meta=siteinfo avec siprop=languages, ou en spécifiant user pour utiliser la préférence de langue de l’utilisateur actuel, ou en spécifiant content pour utiliser le langage du contenu de ce wiki.

Par défaut : user
Exemples :
Aide pour le module principal
api.php?action=help
Toute l’aide sur une page
api.php?action=help&recursivesubmodules=1
Droits :
writeapi
Utiliser l'API de modification du wiki
Accordé à : all, user, bot
apihighlimits
Utiliser des valeurs plus hautes dans les requêtes de l’API (requêtes lentes : 500 ; requêtes rapides : 5000). Les limites pour les requêtes lentes s’appliquent aussi aux paramètres multivalués.
Accordé à : bot, sysop

action=block

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Bloquer un utilisateur.

Paramètres :
user

Nom d’utilisateur, adresse IP ou plage d’adresses IP que vous voulez bloquer.

Ce paramètre est obligatoire.
expiry

Durée d’expiration. Peut être relative (par ex. 5 months ou 2 weeks) ou absolue (par ex. 2014-09-18T12:34:56Z). Si elle est mise à infinite, indefinite ou never, le blocage n’expirera jamais.

Par défaut : never
reason

Motif du blocage.

Par défaut : (vide)
anononly

Bloquer uniquement les utilisateurs anonymes (c’est-à-dire désactiver les modifications anonymes pour cette adresse IP).

nocreate

Empêcher la création de compte.

autoblock

Bloquer automatiquement la dernière adresse IP utilisée, et toute les adresses IP subséquentes depuis lesquelles ils ont essayé de se connecter.

noemail

Empêcher l’utilisateur d’envoyer des courriels via le wiki (nécessite le doit blockemail).

hidename

Masque le nom de l’utilisateur dans le journal des blocages (nécessite le droit hideuser).

allowusertalk

Autoriser les utilisateurs à modifier leur propre page de discussion (dépend de $wgBlockAllowsUTEdit).

reblock

Si l’utilisateur est déjà bloqué, écraser le blocage existant.

watchuser

Surveiller les pages utilisateur et de discussion de l’utilisateur ou de l’adresse IP.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Bloquer l’adresse IP 192.0.2.5 pour trois jours avec le motif Premier avertissement.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC
Bloquer indéfiniment l’utilisateur Vandale avec le motif Vandalisme, et empêcher la création de nouveau compte et l'envoi de courriel.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC

action=checktoken

  • Ce module nécessite des droits de lecture.

Vérifier la validité d'un jeton de action=query&meta=tokens.

Paramètres :
type

Type de jeton testé

Ce paramètre est obligatoire.
Une valeur : csrf, patrol, rollback, userrights, watch
token

Jeton à tester.

Ce paramètre est obligatoire.
maxtokenage

Temps maximum autorisé pour le jeton, en secondes

Exemple :
Tester la validité d'un jeton de csrf.
api.php?action=checktoken&type=csrf&token=123ABC

action=clearhasmsg

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.

Efface le drapeau hasmsg pour l’utilisateur courant.

Exemple :
Effacer le drapeau hasmsg pour l’utilisateur courant
api.php?action=clearhasmsg

action=compare

  • Ce module nécessite des droits de lecture.

Obtenir la différence entre 2 pages.

Vous devez passer un numéro de révision, un titre de page, ou un ID de page, à la fois pour « from » et « to ».

Paramètres :
fromtitle

Premier titre à comparer.

fromid

ID de la première page à comparer.

fromrev

Première révision à comparer.

totitle

Second titre à comparer.

toid

ID de la seconde page à comparer.

torev

Seconde révision à comparer.

Exemple :
Créer une différence entre les révisions 1 et 2
api.php?action=compare&fromrev=1&torev=2

action=createaccount

  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Créer un nouveau compte utilisateur.

Paramètres :
name

Nom d’utilisateur.

Ce paramètre est obligatoire.
password

Mot de passe (ignoré si mailpassword est défini).

domain

Domaine pour l’authentification externe (facultatif).

token

Jeton de création de compte obtenu à la première requête.

email

Adresse de courriel de l’utilisateur (facultatif).

Ce paramètre est obligatoire.
realname

Vrai nom de l’utilisateur (facultatif).

mailpassword

S’il est fixé à une valeur quelconque, un mot de passe aléatoire sera envoyé par courriel à l’utilisateur.

reason

Motif facultatif de création du compte à mettre dans les journaux.

language

Code de langue à mettre par défaut pour l’utilisateur (facultatif, par défaut langue du contenu).

Exemples :
Créer l’utilisateur testuser avec le mot de passe test123.
api.php?action=createaccount&name=testuser&password=test123
Créer l’utilisateur testmailuser et envoyer par courriel un mot de passe généré aléatoirement.
api.php?action=createaccount&name=testmailuser&mailpassword=true&reason=MyReason

action=delete

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Supprimer une page.

Paramètres :
title

Titre de la page que vous voulez supprimer. Impossible de l’utiliser avec pageid.

pageid

ID de la page que vous voulez supprimer. Impossible à utiliser avec title.

reason

Motif de suppression. Si non défini, un motif généré automatiquement sera utilisé.

watch
Obsolète.

Ajouter la page à la liste de suivi de l’utilisateur actuel.

watchlist

Ajouter ou supprimer sans distinction la page de la liste de suivi de l'utilisateur actuel, utiliser les préférences ou ne rien changer au suivi.

Une valeur : watch, unwatch, preferences, nochange
Par défaut : preferences
unwatch
Obsolète.

Supprimer la page de la liste de suivi de l'utilisateur actuel.

oldimage

Le nom de l’ancienne image à supprimer tel que fourni par action=query&prop=imageinfo&iiprop=archivename.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Supprimer Page principale.
api.php?action=delete&title=Main%20Page&token=123ABC
Supprimer Page principale avec le motif Préparation au déplacement
api.php?action=delete&title=Main%20Page&token=123ABC&reason=Preparing%20for%20move

action=edit

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Créer et modifier les pages.

Paramètres :
title

Titre de la page que vous voulez modifier. Impossible de l’utiliser avec pageid.

pageid

ID de la page que vous voulez modifier. Impossible à utiliser avec title.

section

Numéro de section. 0 pour la section de tête, new pour une nouvelle section.

sectiontitle

Le titre pour une nouvelle section.

text

Contenu de la page.

summary

Modifier le résumé. Également le titre de la section quand section=new et sectiontitle n’est pas défini.

tags

Change tags to apply to the revision.

Valeurs (séparées par |) :
minor

Modification mineure.

notminor

Modification non mineure.

bot

Marquer cette modification comme robot.

basetimestamp

Horodatage de la révision de base, utilisé pour détecter les conflits de modification. Peut être obtenu via action=query&prop=revisions&rvprop=timestamp.

starttimestamp

L'horodatage, lorsque le processus d'édition est démarré, est utilisé pour détecter les conflits de modification. Une valeur appropriée peut être obtenue en utilisant curtimestamp lors du démarrage du processus d'édition (par ex. en chargeant le contenu de la page à modifier).

recreate

Ignorer toutes les erreurs concernant la page qui a été supprimée entre-temps.

createonly

Ne pas modifier la page si elle existe déjà.

nocreate

Lever une erreur si la page n’existe pas.

watch
Obsolète.

Ajouter la page à la liste de suivi de l'utilisateur actuel.

unwatch
Obsolète.

Supprimer la page de la liste de suivi de l'utilisateur actuel.

watchlist

Ajouter ou supprimer sans condition la page de votre liste de suivi, utiliser les préférences ou ne pas changer le suivi.

Une valeur : watch, unwatch, preferences, nochange
Par défaut : preferences
md5

Le hachage MD5 du paramètre text, ou les paramètres prependtext et appendtext concaténés. Si défini, la modification ne sera pas effectuée à moins que le hachage ne soit correct.

prependtext

Ajouter ce texte au début de la page. Écrase text.

appendtext

Ajouter ce texte à la fin de la page. Écrase text.

Utiliser section=new pour ajouter une nouvelle section, plutôt que ce paramètre.

undo

Annuler cette révision. Écrase text, prependtext et appendtext.

undoafter

Annuler toutes les révisions depuis undo jusqu’à celle-ci. Si non défini, annuler uniquement une révision.

redirect

Résoudre automatiquement les redirections.

contentformat

Format de sérialisation du contenu utilisé pour le texte d’entrée.

Une valeur : text/x-wiki, text/javascript, application/json, text/css, text/plain
contentmodel

Modèle de contenu du nouveau contenu.

Une valeur : wikitext, javascript, json, css, text
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Le jeton doit toujours être envoyé en tant que dernier paramètre, ou au moins après le paramètre text.

Ce paramètre est obligatoire.

action=emailuser

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Envoyer un courriel à un utilisateur.

Paramètres :
target

Utilisateur à qui envoyer le courriel.

Ce paramètre est obligatoire.
subject

Entête du sujet.

text

Corps du courriel.

Ce paramètre est obligatoire.
ccme

M’envoyer une copie de ce courriel.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemple :
Envoyer un courriel à l’utilisateur WikiSysop avec le texte Contenu.
api.php?action=emailuser&target=WikiSysop&text=Content&token=123ABC

action=expandtemplates

  • Ce module nécessite des droits de lecture.

Développe tous les modèles en wikitexte.

Paramètres :
title

Titre de la page.

Par défaut : API
text

Wikitexte à convertir.

Ce paramètre est obligatoire.
revid

ID de révision, pour {{REVISIONID}} et les variables semblables.

prop

Quelles informations récupérer :

wikitext
Le wikitexte développé.
categories
Toutes les catégories présentes dans l’entrée qui ne sont pas représentées dans le wikitexte de sortie.
properties
Propriétés de page définies en développant les mots magiques dans le wikitexte.
volatile
Si la sortie est volatile et ne devrait pas être réutilisée ailleurs dans la page.
ttl
Le délai maximal après lequel les caches du résultat devraient être invalidés.
parsetree
L’arbre d’analyse XML de l’entrée.

Noter que si aucune valeur n’est sélectionnée, le résultat contiendra le wikitexte, mais la sortie sera dans un format obsolète.

Valeurs (séparées par |) : wikitext, categories, properties, volatile, ttl, parsetree
includecomments

S’il faut inclure les commentaires HTML dans la sortie.

generatexml
Obsolète.

Générer l’arbre d’analyse XML (remplacé par prop=parsetree).

Exemple :
Développe le wikitexte {{Project:Sandbox}}.
api.php?action=expandtemplates&text={{Project:Sandbox}}

action=feedcontributions

  • Ce module nécessite des droits de lecture.

Renvoie le fil des contributions d’un utilisateur.

Paramètres :
feedformat

Le format du flux.

Une valeur : rss, atom
Par défaut : rss
user

Pour quels utilisateurs récupérer les contributions.

Ce paramètre est obligatoire.
namespace

Par quels espaces de nom filtrer les contributions.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
year

Depuis l’année (et plus récent).

month

Depuis le mois (et plus récent).

tagfilter

Filtrer les contributions qui ont ces balises.

Valeurs (séparées par |) :
Par défaut : (vide)
deletedonly

Afficher uniquement les contributions supprimées.

toponly

Afficher uniquement les modifications qui sont les dernières révisions.

newonly

Afficher uniquement les modifications qui sont des créations de page.

showsizediff

Afficher la différence de taille entre les révisions.

Exemple :
Renvoyer les contributions de l'utilisateur Exemple.
api.php?action=feedcontributions&user=Example

action=feedrecentchanges

  • Ce module nécessite des droits de lecture.

Renvoie un fil de modifications récentes.

Paramètres :
feedformat

Le format du flux.

Une valeur : rss, atom
Par défaut : rss
namespace

Espace de noms auquel limiter les résultats.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
invert

Tous les espaces de nom sauf le sélectionné.

associated

Inclure l’espace de noms associé (discussion ou principal).

days

Jours auxquels limiter le résultat.

La valeur doit être inférieure à 1.
Par défaut : 7
limit

Nombre maximal de résultats à renvoyer.

La valeur doit être entre 1 et 50.
Par défaut : 50
from

Afficher les modifications depuis lors.

hideminor

Masquer les modifications mineures.

hidebots

Masquer les modifications faites par des robots.

hideanons

Masquer les modifications faites par des utilisateurs anonymes.

hideliu

Masquer les modifications faites par des utilisateurs enregistrés.

hidepatrolled

Masquer les modifications contrôlées.

hidemyself

Masquer les modifications faites par l'utilisateur actuel.

tagfilter

Filtrer par balise.

target

Afficher uniquement les modifications sur les pages liées depuis cette page.

showlinkedto

Afficher les modifications plutôt sur les pages liées vers la page sélectionnée.

Exemples :
Afficher les modifications récentes
api.php?action=feedrecentchanges
Afficher les modifications récentes sur 30 jours
api.php?action=feedrecentchanges&days=30

action=feedwatchlist

  • Ce module nécessite des droits de lecture.

Renvoie un flux de liste de suivi.

Paramètres :
feedformat

Le format du flux.

Une valeur : rss, atom
Par défaut : rss
hours

Lister les pages modifiées lors de ce nombre d’heures depuis maintenant.

La valeur doit être entre 1 et 72.
Par défaut : 24
linktosections

Lier directement pour modifier les sections si possible.

allrev

Inclure les multiples révisions de la même page dans l’intervalle de temps fourni.

wlowner

Utilisé avec token pour accéder à la liste de suivi d’un autre utilisateur.

wltoken

Un jeton de sécurité (disponible dans les préférences de l’utilsiateur) pour autoriser l’accès à la liste de suivi d&un autre utilisateur.

wlshow

Afficher uniquement les éléments qui correspondent à ces critères. Par exemple, pour voir uniquement les modifications mineures faites par des utilisateurs connectés, mettre show=minor|!anon.

Valeurs (séparées par |) : minor, !minor, bot, !bot, anon, !anon, patrolled, !patrolled, unread, !unread
wltype

Quels types de modification afficher :

edit
Modifications de page normale.
external
Modifications externes.
new
Créations de page.
log
Entrées du journal.
Valeurs (séparées par |) : edit, external, new, log
Par défaut : edit|new|log
wlexcludeuser

Ne pas lister les modifications faites par cet utilisateur.

Exemples :
Afficher le flux de la liste de suivi
api.php?action=feedwatchlist
Afficher toutes les modifications sur les pages suivies dans les dernières 6 heures
api.php?action=feedwatchlist&allrev=&hours=6

action=filerevert

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Rétablir un fichier dans une ancienne version.

Paramètres :
filename

Nom de fichier cible, sans le préfixe File:.

Ce paramètre est obligatoire.
comment

Télécharger le commentaire.

Par défaut : (vide)
archivename

Nom d’archive de la révision à rétablir.

Ce paramètre est obligatoire.
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=help

Afficher l’aide pour les modules spécifiés.

Paramètres :
modules

Modules pour lesquels afficher l’aide (valeurs des paramètres action et format, ou main). Les sous-modules peuvent être spécifiés avec un +.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
Par défaut : main
submodules

Inclure l’aide pour les sous-modules du module nommé.

recursivesubmodules

Inclure l’aide pour les sous-modules de façon récursive.

wrap

Inclut la sortie dans une structure de réponse API standard.

toc

Inclure une table des matières dans la sortir HTML.

Exemples :
Aide pour le module principal
api.php?action=help
Toute l’aide sur une page
api.php?action=help&recursivesubmodules=1
Aide pour le module d’aide lui-même
api.php?action=help&modules=help
Aide pour deux sous-modules de recherche
api.php?action=help&modules=query+info|query+categorymembers

action=imagerotate

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Faire pivoter une ou plusieurs images.

Paramètres :
rotation

Degrés de rotation de l’image dans le sens des aiguilles d’une montre.

Ce paramètre est obligatoire.
Une valeur : 90, 180, 270
continue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

titles

Une liste des titres sur lesquels travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
pageids

Une liste des IDs de page sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
revids

Une liste des IDs de révision sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
generator

Obtenir la liste des pages sur lesquelles travailler en exécutant le module de recherche spécifié.

NOTE : les noms de paramètre du générateur doivent être préfixés avec un « g », voir les exemples.

Une valeur : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
redirects

Résoudre automatiquement les redirections dans titles, pageids et revids, et dans les pages renvoyées par generator.

converttitles

Convertir les titres dans d’autres variantes si nécessaire. Fonctionne uniquement si la langue de contenu du wiki supporte la conversion en variantes. Les langues qui supportent la conversion en variante incluent gan, iu, kk, ku, shi, sr, tg, uz, zh.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=import

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Importer une page depuis un autre wiki, ou un fichier XML.

Noter que le POST HTTP doit être effectué comme un import de fichier (c’est-à-dire en utilisant multipart/form-data) lors de l’envoi d’un fichier pour le paramètre xml.

Paramètres :
summary

Importer le résumé.

xml

Fichier XML téléchargé.

Doit être envoyé comme un fichier importé utilisant multipart/form-data.
interwikisource

Pour les importations interwiki : wiki depuis lequel importer.

Une valeur :
interwikipage

Pour les importations interwiki : page à importer.

fullhistory

Pour les importations interwiki : importer tout l’historique, et pas seulement la version courante.

templates

Pour les importations interwiki : importer aussi tous les modèles inclus.

namespace

Pour les importations interwiki : importer vers cet espace de noms.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
rootpage

Importer comme une sous-page de cette page.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=login (lg)

  • Ce module n’accepte que les requêtes POST.

Se connecter et obtenir les cookies d’authentification.

Dans le cas d’une connexion réussie, les cookies nécessaires seront inclus dans les entêtes de la réponse HTTP. Dans le cas d’une connexion en échec, les essais ultérieurs pourront être réduits afin de limiter les attaques automatisées de découverte du mot de passe.

Paramètres :
lgname

Nom d’utilisateur.

lgpassword

Mot de passe.

lgdomain

Domaine (facultatif).

lgtoken

Jeton de connexion obtenu à la première requête.

action=logout

Se déconnecter et effacer les données de session.

Exemple :
Déconnecter l’utilisateur actuel.
api.php?action=logout

action=managetags

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Effectuer des tâches de gestion relatives à la modification des balises.

Paramètres :
operation

Quelle opération effectuer :

create
Créer une nouvelle balise de modification pour un usage manuel.
delete
Supprimer une balise de modification de la base de données, y compris la suppression de la marque de toutes les révisions, entrées de modification récente et entrées de journal dans lesquelles elle serait utilisée.
activate
Activer une balise de modification, permettant aux utilisateurs de l’appliquer manuellement.
deactivate
Désactiver une balise de modification, empêchant les utilisateurs de l’appliquer manuellement.
Ce paramètre est obligatoire.
Une valeur : create, delete, activate, deactivate
tag

Balise à créer, supprimer, activer ou désactiver. Pour la création de balise, elle ne doit pas exister. Pour la suppression de balise, elle doit exister. Pour l’activation de balise, elle doit exister et ne pas être utilisée par une extension. Pour la désactivation de balise, elle doit être actuellement active et définie manuellement.

Ce paramètre est obligatoire.
reason

Un motif facultatif pour créer, supprimer, activer ou désactiver la balise.

ignorewarnings

S’il faut ignorer tout avertissement qui se produirait au cours de l’opération.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Créer une balise nommée pourriel avec le motif À utiliser lors de la revue des modifications
api.php?action=managetags&operation=create&tag=spam&reason=For+use+in+edit+patrolling&token=123ABC
Supprimer la balise vandlaisme avec le motif Mal épelé
api.php?action=managetags&operation=delete&tag=vandlaism&reason=Misspelt&token=123ABC
Activer une balise nommée pourriel avec le motif À utiliser dans la revue des modifications
api.php?action=managetags&operation=activate&tag=spam&reason=For+use+in+edit+patrolling&token=123ABC
Désactiver une balise nommée pourriel avec le motif Plus nécessaire
api.php?action=managetags&operation=deactivate&tag=spam&reason=No+longer+required&token=123ABC

action=move

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Déplacer une page.

Paramètres :
from

Titre de la page à renommer. Impossible de l’utiliser avec fromid.

fromid

ID de la page à renommer. Impossible à utiliser avec from.

to

Titre de la page renommée.

Ce paramètre est obligatoire.
reason

Motif du renommage.

Par défaut : (vide)
movetalk

Renommer la page de discussion, si elle existe.

movesubpages

Renommer les sous-pages, le cas échéant.

noredirect

Ne pas créer une redirection.

watch
Obsolète.

Ajouter une page et la redirection à liste de suivi de l'utilisateur actuel.

unwatch
Obsolète.

Supprimer la page et la redirection de la liste de suivi de l'utilisateur actuel.

watchlist

Ajouter ou supprimer sans condition la page de la liste de suivi de l'utilisateur actuel, utiliser les préférences ou ne pas changer le suivi.

Une valeur : watch, unwatch, preferences, nochange
Par défaut : preferences
ignorewarnings

Ignorer tous les avertissements.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemple :
Déplacer Mauvais titre en Bon titre sans garder de redirection.
api.php?action=move&from=Badtitle&to=Goodtitle&token=123ABC&reason=Misspelled%20title&movetalk=&noredirect=

action=opensearch

  • Ce module nécessite des droits de lecture.

Rechercher dans le wiki en utilisant le protocole OpenSearch.

Paramètres :
search

Chaîne de recherche.

limit

Nombre maximal de résultats à renvoyer.

Pas plus de 100 autorisé (100 pour les robots).
Par défaut : 10
namespace

Espaces de nom à rechercher.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
suggest

Ne rien faire si $wgEnableOpenSearchSuggest vaut faux.

redirects

Comment gérer les redirections :

return
Renvoie la redirection elle-même.
resolve
Renvoie la page cible. Peut renvoyer moins de limit résultats.

Pour des raisons historiques, la valeur par défaut est « return » pour format=json et « resolve » pour les autres formats.

Une valeur : return, resolve
format

Le format de sortie.

Une valeur : json, jsonfm, xml, xmlfm
Par défaut : json
warningsaserror

If warnings are raised with format=json, return an API error instead of ignoring them.

Exemple :
Trouver les pages commençant par Te.
api.php?action=opensearch&search=Te

action=options

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Modifier les préférences de l’utilisateur courant.

Seules les options enregistrées dans le cœur ou dans l’une des extensions installées, ou les options avec une clé préfixée par « userjs- » (devant être utilisées dans les scripts utilisateur), peuvent être définies.

Paramètres :
reset

Réinitialise les préférences aux valeurs par défaut du site.

resetkinds

Liste des types d’option à réinitialiser quand l’option reset est définie.

Valeurs (séparées par |) : registered, registered-multiselect, registered-checkmatrix, userjs, special, unused, all
Par défaut : all
change

Liste des modifications, au format nom=valeur (par ex. skin=vector). La valeur ne peut pas contenir de caractère barre verticale. Si aucune valeur n’est fournie (pas même un signe égal), par ex., nomoption|autreoption|…, l’option sera réinitialisée à sa valeur par défaut.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
optionname

Un nom d’option qui doit être fixé à la valeur fournie par optionvalue.

optionvalue

La valeur d’une option spécifiée par optionname peut contenir des caractères barre verticale.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Réinitialiser toutes les préférences
api.php?action=options&reset=&token=123ABC
Modifier les préférences skin et hideminor.
api.php?action=options&change=skin=vector|hideminor=1&token=123ABC
Réinitialiser toutes les préférences, puis définir skin et nickname.
api.php?action=options&reset=&change=skin=monobook&optionname=nickname&optionvalue=[[User:Beau|Beau]]%20([[User_talk:Beau|talk]])&token=123ABC

action=paraminfo

Obtenir des informations sur les modules de l’API.

Paramètres :
modules

Liste des noms de module (valeurs des paramètres action et format, ou main). Peut spécifier des sous-modules avec un +.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
helpformat

Format des chaînes d’aide.

Une valeur : html, wikitext, raw, none
Par défaut : none
querymodules
Obsolète.

Liste des noms de module de requêtage (valeur des paramètres prop, meta ou list=). Utiliser modules=query+foo au lieu de querymodules=foo.

Valeurs (séparées par |) : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allmessages, allpages, allredirects, alltransclusions, allusers, backlinks, blocks, categories, categoryinfo, categorymembers, contributors, deletedrevisions, deletedrevs, duplicatefiles, embeddedin, extlinks, exturlusage, filearchive, filerepoinfo, fileusage, imageinfo, images, imageusage, info, iwbacklinks, iwlinks, langbacklinks, langlinks, links, linkshere, logevents, pagepropnames, pageprops, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, siteinfo, stashimageinfo, tags, templates, tokens, transcludedin, usercontribs, userinfo, users, watchlist, watchlistraw
Le nombre maximal de valeurs est 50 (500 pour les robots).
mainmodule
Obsolète.

Obtenir aussi des informations sur le module principal (niveau supérieur). Utiliser plutôt modules=main.

pagesetmodule
Obsolète.

Obtenir aussi des informations sur le module pageset (en fournissant titles= et ses amis).

formatmodules
Obsolète.

Liste des noms de module de mise en forme (valeur du paramètre format). Utiliser plutôt modules.

Valeurs (séparées par |) : dbg, dbgfm, dump, dumpfm, json, jsonfm, none, php, phpfm, rawfm, txt, txtfm, wddx, wddxfm, xml, xmlfm, yaml, yamlfm

action=parse

  • Ce module nécessite des droits de lecture.

Analyse le contenu et renvoie le résultat de l’analyseur.

Voyez les différents modules prop de action=query pour avoir de l’information sur la version actuelle d’une page.

Il y a plusieurs moyens de spécifier le texte à analyser :

  1. Spécifier une page ou une révision, en utilisant page, pageid ou oldid.
  2. Spécifier explicitement un contenu, en utilisant text, title et contentmodel
  3. Spécifier uniquement un résumé à analyser. prop doit recevoir une valeur vide.
Paramètres :
title

Titre de la page à laquelle appartient le texte. Si omis, contentmodel doit être spécifié, et API sera utilisé comme titre.

text

Texte à analyser. utiliser title ou contentmodel pour contrôler le modèle de contenu.

summary

Résumé à analyser.

page

Analyser le contenu de cette page. Impossible à utiliser avec text et title.

pageid

Analyser le contenu de cette page. Écrase page.

redirects

Si le paramètre page ou pageid est positionné sur une redirection, la résoudre.

oldid

Analyser le contenu de cette révision. Écrase page et pageid.

prop

Quelles informations obtenir :

text
Fournit le texte analysé du wikitexte.
langlinks
Fournit les liens de langue dans le wikitexte analysé.
categories
Fournit les catégories dans le wikitexte analysé.
categorieshtml
Fournit la version HTML des catégories.
links
Fournit les liens internes dans le wikitexte analysé.
templates
Fournit les modèles dans le wikitexte analysé.
images
Fournit les images dans le wikitexte analysé.
externallinks
Fournit les liens externes dans le wikitexte analysé.
sections
Fournit les sections dans le wikitexte analysé.
revid
Ajoute l’ID de révision de la page analysée.
displaytitle
Ajoute le titre du wikitexte analysé.
headitems
Fournit les éléments à mettre dans le <head> de la page.
headhtml
Fournit le <head> analysé de la page.
modules
Fournit les modules ResourceLoader utilisés sur la page.
indicators
Fournit le HTML des indicateurs d’état de la page utilisés dans la page.
iwlinks
Fournit les liens interwiki dans le wikitexte analysé.
wikitext
Fournit le wikitexte d’origine qui a été analysé.
properties
Fournit différentes propriétés définies dans le wikitexte analysé.
limitreportdata
Fournit le rapport de limite de façon structurée. Ne fournit aucune donnée, quand disablepp est activé.
limitreporthtml
Fournit la version HTML du rapport de limite. Ne fournit aucune donnée, quand disablepp est activé.
Valeurs (séparées par |) : text, langlinks, categories, categorieshtml, links, templates, images, externallinks, sections, revid, displaytitle, headitems, headhtml, modules, indicators, iwlinks, wikitext, properties, limitreportdata, limitreporthtml
Par défaut : text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties
pst

Faire une transformation avant enregistrement de l’entrée avant de l’analyser. Valide uniquement quand utilisé avec du texte.

onlypst

Faire une transformation avant enregistrement (PST) de l’entrée, mais ne pas l’analyser. Renvoie le même wikitexte, après que la PST a été appliquée. Valide uniquement quand utilisé avec text.

effectivelanglinks

Inclut les liens de langue fournis par les extensions (à utiliser avec prop=langlinks).

section

Récupérer uniquement le contenu de ce numéro de section ou quand nouveau génère une nouvelle section.

La nouvelle section est mise à l’honneur uniquement quand text est spécifié.

sectiontitle

Nouveau titre de section quand section vaut nouveau.

À la différence de la modification de page, cela ne revient pas à summary quand il est omis ou vide.

disablepp

Désactiver le rapport PP de la sortie de l’analyseur.

disableeditsection

Désactiver les liens de modification de section de la sortie de l’analyseur.

generatexml

Générer un arbre d’analyse XML (nécessite le modèle de contenu wikitext).

preview

Analyser en mode aperçu.

sectionpreview

Analyser en mode aperçu de section (active aussi le mode aperçu).

disabletoc

Désactiver la table des matières dans la sortie.

contentformat

Format de sérialisation du contenu utilisé pour le texte d’entrée. Valide uniquement si utilisé avec text.

Une valeur : text/x-wiki, text/javascript, application/json, text/css, text/plain
contentmodel

Modèle de contenu du texte d’entrée. Si omis, title doit être spécifié, et la valeur par défaut sera le modèle du titre spécifié. Valide uniquement quand utilisé avec text.

Une valeur : wikitext, javascript, json, css, text

action=patrol

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Patrouiller une page ou une révision.

Paramètres :
rcid

ID de modification récente à patrouiller.

revid

ID de révision à patrouiller.

token

Un jeton « patrol » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Patrouiller une modification récente
api.php?action=patrol&token=123ABC&rcid=230672766
Patrouiller une révision
api.php?action=patrol&token=123ABC&revid=230672766

action=protect

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Modifier le niveau de protection d’une page.

Paramètres :
title

Titre de la page à (dé)protéger. Impossible à utiliser avec pageid.

pageid

ID de la page à (dé)protéger. Impossible à utiliser avec title.

protections

Liste des niveaux de protection, au format action=niveau (par ex. edit=sysop).

NOTE : Toutes les actions non listées auront leur restrictions supprimées.

Ce paramètre est obligatoire.
Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
expiry

Horodatages d’expiration. Si un seul horodatage est fourni, il sera utilisé pour toutes les protections. Utiliser infinite, indefinite, infinity ou never pour une protection sans expiration.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
Par défaut : infinite
reason

Motif de (dé)protection.

Par défaut : (vide)
cascade

Activer la protection en cascade (c’est-à-dire protéger les pages incluses dans cette page). Ignoré si tous les niveaux de protection fournis ne supportent pas la mise en cascade.

watch
Obsolète.

Si activé, ajouter la page (dé)protégée à la liste de suivi de l'utilisateur actuel.

watchlist

Ajouter ou supprimer sans condition la page de la liste de suivi de l'utilisateur actuel, utiliser les préférences ou ne pas modifier le suivi.

Une valeur : watch, unwatch, preferences, nochange
Par défaut : preferences
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=purge

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Vider le cache des titres fournis.

Nécessite une requête POST si l’utilisateur n’est pas connecté.

Paramètres :
forcelinkupdate

Mettre à jour les tables de liens.

forcerecursivelinkupdate

Mettre à jour la table des liens, et mettre à jour les tables de liens pour toute page qui utilise cette page comme modèle

continue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

titles

Une liste des titres sur lesquels travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
pageids

Une liste des IDs de page sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
revids

Une liste des IDs de révision sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
generator

Obtenir la liste des pages sur lesquelles travailler en exécutant le module de recherche spécifié.

NOTE : les noms de paramètre du générateur doivent être préfixés avec un « g », voir les exemples.

Une valeur : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
redirects

Résoudre automatiquement les redirections dans titles, pageids et revids, et dans les pages renvoyées par generator.

converttitles

Convertir les titres dans d’autres variantes si nécessaire. Fonctionne uniquement si la langue de contenu du wiki supporte la conversion en variantes. Les langues qui supportent la conversion en variante incluent gan, iu, kk, ku, shi, sr, tg, uz, zh.

Exemples :
Purger les pages Page principale et API.
api.php?action=purge&titles=Main_Page|API
Purger les 10 premières pages de l’espace de noms principal
api.php?action=purge&generator=allpages&gapnamespace=0&gaplimit=10

action=query

  • Ce module nécessite des droits de lecture.

Extraire des données de et sur MédiaWiki.

Toutes les modifications de données devront d’abord utiliser une requête pour obtenir un jeton, afin d’éviter les abus de la part de sites malveillants.

Paramètres :
prop

Quelles propriétés obtenir des pages demandées.

Valeurs (séparées par |) : categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, extlinks, fileusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, pageprops, redirects, revisions, stashimageinfo, templates, transcludedin
list

Quelles listes obtenir.

Valeurs (séparées par |) : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, allusers, backlinks, blocks, categorymembers, deletedrevs, embeddedin, exturlusage, filearchive, imageusage, iwbacklinks, langbacklinks, logevents, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, usercontribs, users, watchlist, watchlistraw
meta

Quelles métadonnées obtenir.

Valeurs (séparées par |) : allmessages, filerepoinfo, siteinfo, tokens, userinfo
indexpageids

Inclure une section pageids supplémentaire listant tous les IDs de page renvoyés.

export

Exporter les révisions actuelles de toutes les pages fournies ou générées.

exportnowrap

Renvoyer le XML exporté sans l’inclure dans un résultat XML (même format que Special:Export). Utilisable uniquement avec export.

iwurl

S’il faut obtenir l’URL complète si le titre est un lien interwiki.

continue

Quand il est présent, met en forme query-continue sous forme de paires clé-valeur qui devrait simplement être fusionné dans la requête d’origine. Ce paramètre doit être fixé à une chaîne vide dans la requête initiale.

Ce paramètre est recommandé pour tout nouveau développement, et sera mis par défaut dans la prochaine version de l’API.

rawcontinue

Actuellement ignoré. Plus tard, continue deviendra la valeur par défaut et sera nécessaire pour recevoir les données brutes de query-continue.

titles

Une liste des titres sur lesquels travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
pageids

Une liste des IDs de page sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
revids

Une liste des IDs de révision sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
generator

Obtenir la liste des pages sur lesquelles travailler en exécutant le module de recherche spécifié.

NOTE : les noms de paramètre du générateur doivent être préfixés avec un « g », voir les exemples.

Une valeur : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
redirects

Résoudre automatiquement les redirections dans titles, pageids et revids, et dans les pages renvoyées par generator.

converttitles

Convertir les titres dans d’autres variantes si nécessaire. Fonctionne uniquement si la langue de contenu du wiki supporte la conversion en variantes. Les langues qui supportent la conversion en variante incluent gan, iu, kk, ku, shi, sr, tg, uz, zh.

prop=categories (cl)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les catégories auxquelles les pages appartiennent.

Paramètres :
clprop

Quelles propriétés supplémentaires obtenir de chaque catégorie :

sortkey
Ajoute la clé de tri (chaîne hexadécimale) et son préfixe (partie lisible) de la catégorie.
timestamp
Ajoute l’horodatage de l’ajout de la catégorie.
hidden
Marque les catégories cachées avec __HIDDENCAT__.
Valeurs (séparées par |) : sortkey, timestamp, hidden
clshow

Quelle sorte de catégories afficher.

Valeurs (séparées par |) : hidden, !hidden
cllimit

Combien de catégories renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
clcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

clcategories

Lister uniquement ces catégories. Utile pour vérifier si une certaine page est dans une certaine catégorie.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
cldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Obtenir une liste des catégories auxquelles appartient la page Albert Einstein.
api.php?action=query&prop=categories&titles=Albert%20Einstein
Obtenir des informations sur toutes les catégories utilisées dans la page Albert Einstein.
api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info

prop=categoryinfo (ci)

  • Ce module nécessite des droits de lecture.

Renvoie les informations sur les catégories données.

Paramètre :
cicontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemple :
Obtenir des informations sur Category:Foo et Category:Bar.
api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar

prop=contributors (pc)

  • Ce module nécessite des droits de lecture.

Obtenir la liste des contributeurs connectés et le nombre de contributeurs anonymes d’une page.

Paramètres :
pcgroup

Inclure uniquement les utilisateurs dans les groupes donnés. Ne pas inclure les groupes implicites ou auto-promus comme *, user ou autoconfirmed.

Valeurs (séparées par |) : bot, sysop, bureaucrat, WikiSysop
pcexcludegroup

Exclure les utilisateurs des groupes donnés. Ne pas inclure les groupes implicites ou auto-promus comme *, user ou autoconfirmed.

Valeurs (séparées par |) : bot, sysop, bureaucrat, WikiSysop
pcrights

Inclure uniquement les utilisateurs ayant les droits donnés. Ne pas inclure les droits accordés par les groupes implicites ou auto-promus comme *, user ou autoconfirmed.

Valeurs (séparées par |) : apihighlimits, applychangetags, autoconfirmed, autopatrol, bigdelete, block, blockemail, bot, browsearchive, changetags, createaccount, createpage, createtalk, delete, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editprotected, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmywatchlist, editsemiprotected, editusercssjs, editusercss, edituserjs, hideuser, import, importupload, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, movefile, move-categorypages, move-rootuserpages, move-subpages, nominornewtalk, noratelimit, override-export-depth, pagelang, passwordreset, patrol, patrolmarks, protect, proxyunbannable, purge, read, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi
Le nombre maximal de valeurs est 50 (500 pour les robots).
pcexcluderights

Exclure les utilisateurs ayant les droits donnés. Ne pas inclure les droits accordés par les groupes implicites ou auto-promus comme *, user ou autoconfirmed.

Valeurs (séparées par |) : apihighlimits, applychangetags, autoconfirmed, autopatrol, bigdelete, block, blockemail, bot, browsearchive, changetags, createaccount, createpage, createtalk, delete, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editprotected, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmywatchlist, editsemiprotected, editusercssjs, editusercss, edituserjs, hideuser, import, importupload, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, movefile, move-categorypages, move-rootuserpages, move-subpages, nominornewtalk, noratelimit, override-export-depth, pagelang, passwordreset, patrol, patrolmarks, protect, proxyunbannable, purge, read, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi
Le nombre maximal de valeurs est 50 (500 pour les robots).
pclimit

Combien de contributeurs renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
pccontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemple :
Afficher les contributeurs dans la Main Page.
api.php?action=query&prop=contributors&titles=Main_Page

prop=deletedrevisions (drv)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Obtenir des informations sur la révision supprimée.

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

  1. Obtenir les révisions supprimées pour un ensemble de pages, en donnant les titres ou les ids de page. Ordonné par titre et horodatage.
  2. Obtenir des données sur un ensemble de révisions supprimées en donnant leurs IDs et leurs ids de révision. Ordonné par ID de révision.
Paramètres :
drvprop

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
Utilisateur ayant fait la révision.
userid
ID de l’utilisateur ayant créé la révision.
size
Taille (en octets) de la révision.
sha1
SHA-1 (base 16) de la révision.
contentmodel
ID du modèle de contenu de la révision.
comment
Commentaire par l’utilisateur de la révision.
parsedcomment
Commentaire analysé par l’utilisateur de la révision.
content
Texte de la révision.
tags
Balises de la révision.
Valeurs (séparées par |) : ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags
Par défaut : ids|timestamp|flags|comment|user
drvlimit

Limiter le nombre de révisions retournées.

Pas plus de 500 autorisé (5 000 pour les robots).
drvexpandtemplates

Développer les modèles dans le contenu de la révision (nécessite drvprop=content).

drvgeneratexml

Générer l’arbre d’analyse XML pour le contenu de la révision (nécessite drvprop=content).

drvparse

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.

drvsection

Récupérer uniquement le contenu de ce numéro de section.

drvdiffto

ID de révision à comparer à chaque révision. Utiliser prev, next et cur pour la version précédente, suivante et actuelle respectivement.

drvdifftotext

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

drvcontentformat

Format de sérialisation utilisé pour drvdifftotext et attendu pour la sortie du contenu.

Une valeur : text/x-wiki, text/javascript, application/json, text/css, text/plain
drvstart

L’horodatage auquel démarrer l’énumération. Ignoré lors du traitement d’une liste d’IDs de révisions.

drvend

L’horodatage auquel arrêter l’énumération. Ignoré lors du traitement d’une liste d’IDs de révisions.

drvdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : drvstart doit être avant drvend.
older
Lister les nouveaux en premier (par défaut). Note : drvstart doit être postérieur à drvend.
Une valeur : newer, older
Par défaut : older
drvtag

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

drvuser

Lister uniquement les révisions faites par cet utilisateur.

drvexcludeuser

Ne pas lister les révisions faites par cet utilisateur.

drvcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Lister les révisions supprimées des pages Main Page et Talk:Main Page, avec leur contenu.
api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk:Main%20Page&drvprop=user|comment|content
Lister les informations pour la révision supprimée 123456.
api.php?action=query&prop=deletedrevisions&revids=123456

prop=duplicatefiles (df)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister tous les fichiers qui sont des doublons des fichiers donnés d’après leurs valeurs de hachage.

Paramètres :
dflimit

Combien de fichiers dupliqués à renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
dfcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

dfdir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
dflocalonly

Rechercher les fichiers uniquement dans le référentiel local.

  • Ce module nécessite des droits de lecture.

Renvoyer toutes les URLs externes (non interwikis) des pages données.

Paramètres :
ellimit

Combien de liens renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
eloffset

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

elprotocol

Protocole de l’URL. Si vide et elquery est positionné, le protocole est http. Laisser à la fois ceci et elquery vide pour lister tous les liens externes.

Une valeur : Peut être vide, ou bitcoin, ftp, ftps, geo, git, gopher, http, https, irc, ircs, magnet, mailto, mms, news, nntp, redis, sftp, sip, sips, sms, ssh, svn, tel, telnet, urn, worldwind, xmpp
Par défaut : (vide)
elquery

Rechercher une chaîne sans protocole. Utile pour vérifier si une certaine page contient une certaine URL externe.

elexpandurl

Étendre les URLs relatives au protocole avec le protocole canonique.

Exemple :
Obtenir une liste des liens externes de Main Page.
api.php?action=query&prop=extlinks&titles=Main%20Page

prop=fileusage (fu)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui utilisent les fichiers donnés.

Paramètres :
fuprop

Quelles propriétés obtenir :

pageid
ID de chaque page.
title
Titre de chaque page.
redirect
Marque si la page est une redirection.
Valeurs (séparées par |) : pageid, title, redirect
Par défaut : pageid|title|redirect
funamespace

Inclure uniquement les pages dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
fushow

Afficher uniquement les éléments qui correspondent à ces critères :

redirect
Afficher uniquement les redirections.
!redirect
Afficher uniquement les non-redirections.
Valeurs (séparées par |) : redirect, !redirect
fulimit

Combien renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
fucontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

prop=imageinfo (ii)

  • Ce module nécessite des droits de lecture.

Renvoyer l’information de fichier et l’historique de téléchargement.

Paramètres :
iiprop

Quelles informations obtenir du fichier :

timestamp
Ajoute l’horodatage de la version téléchargée.
user
Ajoute l’utilisateur qui a téléchargé chaque version du fichier.
userid
Ajoute l’ID de l’utilisateur qui a téléchargé chaque version du fichier.
comment
Commentaire sur la version.
parsedcomment
Analyser le commentaire sur cette version.
canonicaltitle
Ajoute le titre canonique du fichier.
url
Fournit l’URL du fichier et la page de description.
size
Ajoute la taille du fichier en octets et la hauteur, la largeur et le nombre de pages (si applicable).
dimensions
Alias pour la taille.
sha1
Ajoute le hachage SHA-1 pour le fichier.
mime
Ajoute le type MIME du fichier.
thumbmime
Ajoute le type MIME de la vignette de l’image (nécessite l’URL et le paramètre iiurlwidth).
mediatype
Ajoute le type de média du fichier.
metadata
Liste les métadonnées Exif de la version du fichier.
commonmetadata
Liste les métadonnées génériques du format du fichier pour la version du fichier.
extmetadata
Liste les métadonnées mises en forme combinées depuis différentes sources. Les résultats sont au format HTML.
archivename
Ajoute le nom de fichier de la version d’archive pour les versions autres que la dernière.
bitdepth
Ajoute la profondeur de bit de la version.
uploadwarning
Utilisé par la page Special:Upload pour obtenir de l’information sur un fichier existant. Non prévu pour être utilisé en dehors du cœur de MédiaWiki.
timestamp
Ajoute l’horodatage à la version téléchargée.
user
Ajoute l’utilisateur qui a téléchargé chaque version du fichier.
userid
Ajouter l’ID de l’utilisateur qui a téléchargé chaque version du fichier.
comment
Commentaire sur la version.
parsedcomment
Analyser le commentaire de la version.
canonicaltitle
Ajoute le titre canonique du fichier.
url
Fournit l’URL du fichier et de la page de description.
size
Ajoute la taille du fichier en octets et sa hauteur, largeur et compteur de page (le cas échéant).
dimensions
Alias pour la taille.
sha1
Ajoute le hachage SH1-1 du fichier.
mime
Ajoute le type MIME du fichier.
thumbmime
Ajoute le type MIME de la vignette de l’image (nécessite l’URL et le paramètre iiurlwidth).
mediatype
Ajoute le type de média du fichier.
metadata
Liste les métadonnées Exif de la version du fichier.
commonmetadata
Liste les métadonnées génériques du format du fichier pour la version du fichier.
extmetadata
Liste les métadonnées mises en forme combinées depuis diverses sources. Les résultats sont au format HTML.
archivename
Ajoute le nom de fichier de la version d’archive pour les versions autres que la dernière.
bitdepth
Ajoute la profondeur de bits de la version.
uploadwarning
Utilisé par la page Special:Upload pour obtenir de l’information sur un fichier existant. Non prévu pour être utilisé en dehors du cœur de MédiaWiki.
Valeurs (séparées par |) : timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning
Par défaut : timestamp|user
iilimit

Combien de révision de fichier renvoyer par fichier.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 1
iistart

Horodatage auquel démarrer la liste.

iiend

Horodatage auquel arrêter la liste.

iiurlwidth

Si iiprop=url est défini, une URL vers une image à l’échelle de cette largeur sera renvoyée. Pour des raisons de performance si cette option est utilisée, pas plus de 50 images mises à l’échelle seront renvoyées.

Par défaut : -1
iiurlheight

Similaire à iiurlwidth.

Par défaut : -1
iimetadataversion

Version de métadonnées à utiliser. Si latest est spécifié, utiliser la dernière version. Par défaut à 1 pour la compatibilité ascendante.

Par défaut : 1
iiextmetadatalanguage

Quelle langue pour analyser extmetadata. Cela affecte à la fois quelle traduction analyser, s’il y en a plusieurs, et comment les choses comme les nombres et d’autres valeurs sont mises en forme.

Par défaut : fr
iiextmetadatamultilang

Si des traductions pour la propriété extmetadata sont disponibles, les analyser toutes.

iiextmetadatafilter

Si spécifié et non vide, seules ces clés seront renvoyées pour iiprop=extmetadata.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
iiurlparam

Une chaîne de paramètre spécifique à l’analyseur. Par exemple, les PDFs peuvent utiliser page15-100px. iiurlwidth doit être utilisé et être cohérent avec iiurlparam.

Par défaut : (vide)
iicontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

iilocalonly

Rechercher les fichiers uniquement dans le référentiel local.

prop=images (im)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Renvoie tous les fichiers contenus dans les pages fournies.

Paramètres :
imlimit

Combien de fichiers renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
imcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

imimages

Lister uniquement ces fichiers. Utile pour vérifier si une page donnée contient un fichier donné.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
imdir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Obtenir une liste des fichiers utilisés dans Main Page
api.php?action=query&prop=images&titles=Main%20Page
Obtenir des informations sur tous les fichiers utilisés dans Main Page
api.php?action=query&generator=images&titles=Main%20Page&prop=info

prop=info (in)

  • Ce module nécessite des droits de lecture.

Obtenir les informations de base sur la page.

Paramètres :
inprop

Quelles propriétés supplémentaires récupérer :

protection
Liste de niveau de protection de chaque page.
talkid
L’ID de la page de discussion pour chaque page qui n’est pas une page de discussion.
watched
Liste de l’état de suivi de chaque page.
watchers
Le nombre d’observateurs, si c&est autorisé.
notificationtimestamp
L’horodatage de notification de la liste de suivi de chaque page.
subjectid
L’ID de la page parente de chaque page de discussion.
url
Fournit une URL complète, une URL de modification, et l’URL canonique pour chaque page.
readable
Si l’utilisateur peut lire cette page.
preload
Fournit le texte renvoyé par EditFormPreloadText.
displaytitle
Fournit la manière dont le titre de la page est vraiment affiché.
protection
Lister le niveau de protection de chaque page.
talkid
L’ID de la page de discussion de chaque page qui n’est pas de discussion.
watched
Lister l’état de suivi de chaque page.
watchers
Le nombre d’observateurs, si c’est autorisé.
notificationtimestamp
L’horodatage de notification de la liste de suivi de chaque page.
subjectid
L’ID de page de la page parent de chaque page de discussion.
url
Fournit une URL complète, une URL de modification, et l’URL canonique de chaque page.
readable
Si l’utilisateur peut lire cette page.
preload
Fournit le texte renvoyé par EditFormPreloadText.
displaytitle
Fournit la manière dont le titre de la page est réellement affiché.
Valeurs (séparées par |) : protection, talkid, watched, watchers, notificationtimestamp, subjectid, url, readable, preload, displaytitle
intestactions

Tester si l’utilisateur actuel peut effectuer certaines actions sur la page.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
intoken
Obsolète.

Utiliser plutôt action=query&meta=tokens.

Valeurs (séparées par |) : edit, delete, protect, move, block, unblock, email, import, watch
incontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Obtenir des informations sur la page Main Page.
api.php?action=query&prop=info&titles=Main%20Page
Obtenir des informations générale et de protection sur la page Main Page.
api.php?action=query&prop=info&inprop=protection&titles=Main%20Page
  • Ce module nécessite des droits de lecture.

Renvoie tous les liens interwiki des pages indiquées.

Paramètres :
iwprop

Quelles propriétés supplémentaires obtenir pour chaque lien interlangue :

url
Ajoute l’URL complète.
Valeurs (séparées par |) : url
iwprefix

Renvoyer uniquement les liens interwiki avec ce préfixe.

iwtitle

Lien interwiki à rechercher. Doit être utilisé avec iwprefix.

iwdir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
iwlimit

Combien de liens interwiki renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
iwcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

iwurl
Obsolète.

S&il faut obtenir l’URL complète (impossible à utiliser avec iwprop).

Exemple :
Obtenir les liens interwiki de la page Main Page.
api.php?action=query&prop=iwlinks&titles=Main%20Page
  • Ce module nécessite des droits de lecture.

Renvoie tous les liens interlangue des pages fournies.

Paramètres :
llprop

Quelles propriétés supplémentaires obtenir pour chaque lien interlangue :

url
Ajoute l’URL complète.
langname
Ajoute le nom localisé de la langue (au mieux). Utiliser llinlanguagecode pour contrôler la langue.
autonym
Ajoute le nom natif de la langue.
Valeurs (séparées par |) : url, langname, autonym
lllang

Renvoyer uniquement les liens interlangue avec ce code de langue.

lltitle

Lien à rechercher. Doit être utilisé avec lllang.

lldir

La direction dans laquelle énumérer.

Une valeur : ascending, descending
Par défaut : ascending
llinlanguagecode

Code de langue pour les noms de langue localisés.

Par défaut : fr
lllimit

Combien de liens interlangue renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
llcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

llurl
Obsolète.

S’il faut récupérer l’URL complète (impossible à utiliser avec llprop).

Exemple :
Obtenir les liens interlangue de la page Main Page.
api.php?action=query&prop=langlinks&titles=Main%20Page&redirects=
  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Renvoie tous les liens des pages fournies.

Paramètres :
plnamespace

Afficher les liens uniquement dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
pllimit

Combien de liens renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
plcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

pltitles

Lister uniquement les liens vers ces titres. Utile pour vérifier si une certaine page a un lien vers un titre donné.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
pldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Obtenir les liens de la page Main Page
api.php?action=query&prop=links&titles=Main%20Page
Obtenir des informations sur tous les liens de page dans Main Page.
api.php?action=query&generator=links&titles=Main%20Page&prop=info
Obtenir les liens de la page Accueil dans les espaces de nom Utilisateur et Modèle.
api.php?action=query&prop=links&titles=Main%20Page&plnamespace=2|10

prop=linkshere (lh)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages ayant un lien vers les pages données.

Paramètres :
lhprop

Quelles propriétés obtenir :

pageid
ID de chaque page.
title
Titre de chaque page.
redirect
Indique si la page est une redirection.
Valeurs (séparées par |) : pageid, title, redirect
Par défaut : pageid|title|redirect
lhnamespace

Inclure uniquement les pages dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
lhshow

Afficher uniquement les éléments qui correspondent à ces critères :

redirect
Afficher uniquement les redirections.
!redirect
Afficher uniquement les non-redirections.
Valeurs (séparées par |) : redirect, !redirect
lhlimit

Combien de résultats renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
lhcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Obtenir une liste des pages liées à Main Page
api.php?action=query&prop=linkshere&titles=Main%20Page
Obtenir des informations sur les pages liées à Main Page
api.php?action=query&generator=linkshere&titles=Main%20Page&prop=info

prop=pageprops (pp)

  • Ce module nécessite des droits de lecture.

Obtenir diverses propriétés définies dans le contenu de la page.

Paramètres :
ppcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

ppprop

Lister uniquement ces propriétés. Utile pour vérifier si une certaine page utilise une certaine propriété de page.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
Exemple :
Obtenir les propriétés de Category:Foo.
api.php?action=query&prop=pageprops&titles=Category:Foo

prop=redirects (rd)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Renvoie toutes les redirections vers les pages données.

Paramètres :
rdprop

Quelles propriétés récupérer :

pageid
ID de page de chaque redirection.
title
Titre de chaque redirection.
fragment
Fragment de chaque redirection, s’il y en a un.
Valeurs (séparées par |) : pageid, title, fragment
Par défaut : pageid|title
rdnamespace

Inclure uniquement les pages dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
rdshow

Afficher uniquement les éléments correspondant à ces critères :

fragment
Afficher uniquement les redirections avec un fragment.
!fragment
Afficher uniquement les redirections sans fragment.
Valeurs (séparées par |) : fragment, !fragment
rdlimit

Combien de redirections renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
rdcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Obtenir une liste des redirections vers Main Page
api.php?action=query&prop=redirects&titles=Main%20Page
Obtenir des informations sur toutes les redirections vers Main Page
api.php?action=query&generator=redirects&titles=Main%20Page&prop=info

prop=revisions (rv)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Obtenir des informations sur la révision.

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

  1. Obtenir des données sur un ensemble de pages (dernière révision), en mettant les titres ou les ids de page.
  2. Obtenir les révisions d’une page donnée, en utilisant les titres ou les ids de page avec début, fin ou limite.
  3. Obtenir des données sur un ensemble de révisions en donnant leurs IDs et leurs ids de révision.
Paramètres :
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
Utilisateur ayant fait la révision.
userid
ID de l’utilisateur ayant créé la révision.
size
Taille (en octets) de la révision.
sha1
SHA-1 (base 16) de la révision.
contentmodel
ID du modèle de contenu de la révision.
comment
Commentaire par l’utilisateur de la révision.
parsedcomment
Commentaire analysé par l’utilisateur de la révision.
content
Texte de la révision.
tags
Balises de la révision.
Valeurs (séparées par |) : ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags
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).
rvexpandtemplates

Développer les modèles dans le contenu de la révision (nécessite rvprop=content).

rvgeneratexml

Générer l’arbre d’analyse XML pour le contenu de la révision (nécessite rvprop=content).

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.

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

rvcontentformat

Format de sérialisation utilisé pour rvdifftotext et attendu pour la sortie du contenu.

Une valeur : 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).
rvendid

Arrêter l’énumération des révisions à cet ID.

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

À quel horodatage de révision démarrer l’énumération.

Utilisable uniquement avec une seule page (mode #2).
rvend

Énumérer jusqu’à cet horodatage.

Utilisable uniquement avec une seule page (mode #2).
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 valeur : newer, older
Par défaut : older
rvuser

Inclure uniquement les révisions faites par l’utilisateur.

Utilisable uniquement avec une seule page (mode #2).
rvexcludeuser

Exclure les révisions faites par l’utilisateur.

Utilisable uniquement avec une seule page (mode #2).
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.

Exemples :
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
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
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
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
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
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

prop=stashimageinfo (sii)

  • Ce module nécessite des droits de lecture.

Renvoie les informations de fichier des fichiers mis en réserve.

Paramètres :
siifilekey

Clé qui identifie un téléchargement précédent qui a été temporairement mis en réserve.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
siisessionkey
Obsolète.

Alias pour siifilekey, pour la compatibilité descendante.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
siiprop

Quelles informations obtenir du fichier :

timestamp
Ajoute l’horodatage de la version téléchargée.
user
Ajoute l’utilisateur qui a téléchargé chaque version du fichier.
userid
Ajoute l’ID de l’utilisateur qui a téléchargé chaque version du fichier.
comment
Commentaire sur la version.
parsedcomment
Analyser le commentaire sur cette version.
canonicaltitle
Ajoute le titre canonique du fichier.
url
Fournit l’URL du fichier et la page de description.
size
Ajoute la taille du fichier en octets et la hauteur, la largeur et le nombre de pages (si applicable).
dimensions
Alias pour la taille.
sha1
Ajoute le hachage SHA-1 pour le fichier.
mime
Ajoute le type MIME du fichier.
thumbmime
Ajoute le type MIME de la vignette de l’image (nécessite l’URL et le paramètre siiurlwidth).
mediatype
Ajoute le type de média du fichier.
metadata
Liste les métadonnées Exif de la version du fichier.
commonmetadata
Liste les métadonnées génériques du format du fichier pour la version du fichier.
extmetadata
Liste les métadonnées mises en forme combinées depuis différentes sources. Les résultats sont au format HTML.
archivename
Ajoute le nom de fichier de la version d’archive pour les versions autres que la dernière.
bitdepth
Ajoute la profondeur de bit de la version.
uploadwarning
Utilisé par la page Special:Upload pour obtenir de l’information sur un fichier existant. Non prévu pour être utilisé en dehors du cœur de MédiaWiki.
timestamp
Ajoute l’horodatage à la version téléchargée.
canonicaltitle
Ajoute le titre canonique du fichier.
url
Fournit l’URL du fichier et de la page de description.
size
Ajoute la taille du fichier en octets et sa hauteur, largeur et compteur de page (le cas échéant).
dimensions
Alias pour la taille.
sha1
Ajoute le hachage SH1-1 du fichier.
mime
Ajoute le type MIME du fichier.
thumbmime
Ajoute le type MIME de la vignette de l’image (nécessite l’URL et le paramètre siiurlwidth).
metadata
Liste les métadonnées Exif de la version du fichier.
commonmetadata
Liste les métadonnées génériques du format du fichier pour la version du fichier.
extmetadata
Liste les métadonnées mises en forme combinées depuis diverses sources. Les résultats sont au format HTML.
bitdepth
Ajoute la profondeur de bits de la version.
Valeurs (séparées par |) : timestamp, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, metadata, commonmetadata, extmetadata, bitdepth
Par défaut : timestamp|url
siiurlwidth

Si siiprop=url est défini, une URL vers une image à l’échelle de cette largeur sera renvoyée. Pour des raisons de performance si cette option est utilisée, pas plus de 50 images mises à l’échelle seront renvoyées.

Par défaut : -1
siiurlheight

Similaire à siiurlwidth.

Par défaut : -1
siiurlparam

Une chaîne de paramètre spécifique à l’analyseur. Par exemple, les PDFs peuvent utiliser page15-100px. siiurlwidth doit être utilisé et être cohérent avec siiurlparam.

Par défaut : (vide)
Exemples :
Renvoie les informations sur un fichier mis en réserve.
api.php?action=query&prop=stashimageinfo&siifilekey=124sd34rsdf567
Renvoie les vignettes pour deux fichiers mis en réserve
api.php?action=query&prop=stashimageinfo&siifilekey=b34edoe3|bceffd4&siiurlwidth=120&siiprop=url

prop=templates (tl)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Renvoie toutes les pages incluses dans les pages fournies.

Paramètres :
tlnamespace

Afficher les modèles uniquement dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
tllimit

Combien de modèles renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
tlcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

tltemplates

Lister uniquement ces modèles. Utile pour vérifier si une certaine page utilise un modèle donné.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
tldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Obtenir les modèles utilisés sur la page Accueil.
api.php?action=query&prop=templates&titles=Main%20Page
Obtenir des informations sur les pages modèle utilisé sur Main Page.
api.php?action=query&generator=templates&titles=Main%20Page&prop=info
Obtenir les pages des espaces de nom Utilisateur et Modèle qui sont inclues dans la page <kdb>Main Page<kdb>.
api.php?action=query&prop=templates&titles=Main%20Page&tlnamespace=2|10

prop=transcludedin (ti)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui incluent les pages données.

Paramètres :
tiprop

Quelles propriétés obtenir :

pageid
ID de page de chaque page.
title
Titre de chaque page.
redirect
Marque si cette page est une redirection.
Valeurs (séparées par |) : pageid, title, redirect
Par défaut : pageid|title|redirect
tinamespace

Inclure uniquement les pages dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
tishow

Afficher uniquement les éléments qui correspondent à ces critères:

redirect
Afficher uniquement les redirections.
!redirect
Afficher uniquement les non-redirections.
Valeurs (séparées par |) : redirect, !redirect
tilimit

Combien en renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
ticontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Obtenir une liste des pages incluant Main Page.
api.php?action=query&prop=transcludedin&titles=Main%20Page
Obtenir des informations sur les pages incluant Main Page.
api.php?action=query&generator=transcludedin&titles=Main%20Page&prop=info

list=allcategories (ac)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Énumérer toutes les catégories.

Paramètres :
acfrom

La catégorie depuis laquelle démarrer l’énumération.

accontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

acto

La catégorie à laquelle terminer l’énumération.

acprefix

Rechercher tous les titres de catégorie qui commencent avec cette valeur.

acdir

Direction dans laquelle trier.

Une valeur : ascending, descending
Par défaut : ascending
acmin

Renvoyer uniquement les catégories avec au moins ce nombre de membres.

acmax

Renvoyer uniquement les catégories avec au plus ce nombre de membres.

aclimit

Combien de catégories renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
acprop

Quelles propriétés récupérer :

size
Ajoute le nombre de pages dans la catégorie.
hidden
Marque les catégories qui sont cachées avec __HIDDENCAT__.
Valeurs (séparées par |) : size, hidden
Par défaut : (vide)
Exemples :
Lister les catégories avec l’information sur le nombre de pages dans chacune
api.php?action=query&list=allcategories&acprop=size
Récupérer l’information sur la page de catégorie elle-même pour les catégories commençant par List.
api.php?action=query&generator=allcategories&gacprefix=List&prop=info

list=alldeletedrevisions (adr)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les révisions supprimées par un utilisateur ou dans un espace de noms.

Paramètres :
adrprop

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
Utilisateur ayant fait la révision.
userid
ID de l’utilisateur ayant créé la révision.
size
Taille (en octets) de la révision.
sha1
SHA-1 (base 16) de la révision.
contentmodel
ID du modèle de contenu de la révision.
comment
Commentaire par l’utilisateur de la révision.
parsedcomment
Commentaire analysé par l’utilisateur de la révision.
content
Texte de la révision.
tags
Balises de la révision.
Valeurs (séparées par |) : ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags
Par défaut : ids|timestamp|flags|comment|user
adrlimit

Limiter le nombre de révisions retournées.

Pas plus de 500 autorisé (5 000 pour les robots).
adrexpandtemplates

Développer les modèles dans le contenu de la révision (nécessite adrprop=content).

adrgeneratexml

Générer l’arbre d’analyse XML pour le contenu de la révision (nécessite adrprop=content).

adrparse

Analyser le contenu de la révision (nécessite adrprop=content). Pour des raisons de performance, si cette option est utilisée, adrlimit est forcé à 1.

adrsection

Récupérer uniquement le contenu de ce numéro de section.

adrdiffto

ID de révision à comparer à chaque révision. Utiliser prev, next et cur pour la version précédente, suivante et actuelle respectivement.

adrdifftotext

Texte auquel comparer chaque révision. Compare uniquement un nombre limité de révisions. Écrase adrdiffto. Si adrsection est positionné, seule cette section sera comparée avec ce texte

adrcontentformat

Format de sérialisation utilisé pour adrdifftotext et attendu pour la sortie du contenu.

Une valeur : text/x-wiki, text/javascript, application/json, text/css, text/plain
adruser

Lister uniquement les révisions par cet utilisateur.

adrnamespace

Lister uniquement les pages dans cet espace de noms.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
adrstart

L’horodatage auquel démarrer l’énumération.

Utilisable uniquement avec adruser.
adrend

L’horodatage auquel arrêter l’énumération.

Utilisable uniquement avec adruser.
adrdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : adrstart doit être avant adrend.
older
Lister les nouveaux en premier (par défaut). Note : adrstart doit être postérieur à adrend.
Une valeur : newer, older
Par défaut : older
adrfrom

Démarrer la liste à ce titre.

Impossible à utiliser avec adruser.
adrto

Arrêter la liste à ce titre.

Impossible à utiliser avec adruser.
adrprefix

Rechercher tous les titres de page commençant par cette valeur.

Impossible à utiliser avec adruser.
adrexcludeuser

Ne pas lister les révisions par cet utilisateur.

Impossible à utiliser avec adruser.
adrtag

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

adrcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

adrgeneratetitles

Utilisé comme générateur, générer des titres plutôt que des IDs de révision.

Exemples :
Lister les 50 dernières contributions supprimées par l'utilisateur Exemple.
api.php?action=query&list=alldeletedrevisions&adruser=Example&adrlimit=50
Lister les 50 premières révisions supprimées dans l’espace de noms principal.
api.php?action=query&list=alldeletedrevisions&adrdir=newer&adrlimit=50

list=allfileusages (af)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les utilisations de fichier, y compris ceux n’existant pas.

Paramètres :
afcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

affrom

Le titre du fichier depuis lequel commencer l’énumération.

afto

Le titre du fichier auquel arrêter l’énumération.

afprefix

Rechercher tous les fichiers dont le titre commence par cette valeur.

afunique

Afficher uniquement les titres de fichier distincts. Impossible à utiliser avec afprop=ids. Quand utilisé comme générateur, produit les pages cibles au lieu des sources.

afprop

Quelles informations inclure :

ids
Ajoute l’ID de la page utilisatrice (impossible à utiliser avec afunique).
title
Ajoute le titre du fichier.
Valeurs (séparées par |) : ids, title
Par défaut : title
aflimit

Combien d’éléments renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
afdir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Lister les titres de fichier, y compris les manquants, avec les IDs de page d’où ils proviennent, en commençant à B.
api.php?action=query&list=allfileusages&affrom=B&afprop=ids|title
Lister les titres de fichier uniques
api.php?action=query&list=allfileusages&afunique=&affrom=B
Obtient tous les titres de fichier, en marquant les manquants
api.php?action=query&generator=allfileusages&gafunique=&gaffrom=B
Obtient les pages contenant les fichiers
api.php?action=query&generator=allfileusages&gaffrom=B

list=allimages (ai)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Énumérer toutes les images séquentiellement.

Paramètres :
aisort

Propriété par laquelle trier.

Une valeur : name, timestamp
Par défaut : name
aidir

La direction dans laquelle lister.

Une valeur : ascending, descending, newer, older
Par défaut : ascending
aifrom

Le titre de l’image depuis laquelle démarrer l’énumération. Ne peut être utilisé qu’avec aisort=name.

aito

Le titre de l’image auquel arrêter l’énumération. Ne peut être utilisé qu’avec aisort=name.

aicontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

aistart

L’horodatage depuis lequel énumérer. Ne peut être utilisé qu’avec aisort=timestamp.

aiend

L’horodatage de fin de l’énumération. Ne peut être utilisé qu’avec aisort=timestamp.

aiprop

Quelles informations obtenir du fichier :

timestamp
Ajoute l’horodatage de la version téléchargée.
user
Ajoute l’utilisateur qui a téléchargé chaque version du fichier.
userid
Ajoute l’ID de l’utilisateur qui a téléchargé chaque version du fichier.
comment
Commentaire sur la version.
parsedcomment
Analyser le commentaire sur cette version.
canonicaltitle
Ajoute le titre canonique du fichier.
url
Fournit l’URL du fichier et la page de description.
size
Ajoute la taille du fichier en octets et la hauteur, la largeur et le nombre de pages (si applicable).
dimensions
Alias pour la taille.
sha1
Ajoute le hachage SHA-1 pour le fichier.
mime
Ajoute le type MIME du fichier.
thumbmime
Ajoute le type MIME de la vignette de l’image (nécessite l’URL et le paramètre aiurlwidth).
mediatype
Ajoute le type de média du fichier.
metadata
Liste les métadonnées Exif de la version du fichier.
commonmetadata
Liste les métadonnées génériques du format du fichier pour la version du fichier.
extmetadata
Liste les métadonnées mises en forme combinées depuis différentes sources. Les résultats sont au format HTML.
archivename
Ajoute le nom de fichier de la version d’archive pour les versions autres que la dernière.
bitdepth
Ajoute la profondeur de bit de la version.
uploadwarning
Utilisé par la page Special:Upload pour obtenir de l’information sur un fichier existant. Non prévu pour être utilisé en dehors du cœur de MédiaWiki.
timestamp
Ajoute l’horodatage à la version téléchargée.
user
Ajoute l’utilisateur qui a téléchargé chaque version du fichier.
userid
Ajouter l’ID de l’utilisateur qui a téléchargé chaque version du fichier.
comment
Commentaire sur la version.
parsedcomment
Analyser le commentaire de la version.
canonicaltitle
Ajoute le titre canonique du fichier.
url
Fournit l’URL du fichier et de la page de description.
size
Ajoute la taille du fichier en octets et sa hauteur, largeur et compteur de page (le cas échéant).
dimensions
Alias pour la taille.
sha1
Ajoute le hachage SH1-1 du fichier.
mime
Ajoute le type MIME du fichier.
mediatype
Ajoute le type de média du fichier.
metadata
Liste les métadonnées Exif de la version du fichier.
commonmetadata
Liste les métadonnées génériques du format du fichier pour la version du fichier.
extmetadata
Liste les métadonnées mises en forme combinées depuis diverses sources. Les résultats sont au format HTML.
bitdepth
Ajoute la profondeur de bits de la version.
Valeurs (séparées par |) : timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, mediatype, metadata, commonmetadata, extmetadata, bitdepth
Par défaut : timestamp|url
aiprefix

Rechercher toutes les images dont le titre commence par cette valeur. Utilisable uniquement avec aisort=name.

aiminsize

Restreindre aux images avec au moins ce nombre d’octets.

aimaxsize

Restreindre aux images avec au plus ce nombre d’octets.

aisha1

Hachage SHA1 de l’image. Écrase aisha1base36.

aisha1base36

Hachage SHA1 de l’image en base 36 (utilisé dans MédiaWiki).

aiuser

Renvoyer seulement les fichiers téléchargés par cet utilisateur. Utilisable uniquement avec aisort=timestamp. Impossible à utiliser avec aifilterbots.

aifilterbots

Comment filtrer les fichiers téléchargés par des robots. Peut être utilisé uniquement avec aisort=timestamp. Impossible à utiliser avec aiuser.

Une valeur : all, bots, nobots
Par défaut : all
aimime

Quels types MIME rechercher, par ex. image/jpeg.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
ailimit

Combien d’images renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
Exemples :
Afficher une liste des fichiers commençant par la lettre B.
api.php?action=query&list=allimages&aifrom=B
Afficher une liste des fichiers récemment téléchargés semblable à Special:NewFiles
api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older
Afficher une liste de fichiers avec le type MIME image/png ou image/gif
api.php?action=query&list=allimages&aimime=image/png|image/gif
Afficher l’information sur 4 fichiers commençant par la lettre T.
api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo
  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Énumérer tous les liens pointant vers un espace de noms donné.

Paramètres :
alcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

alfrom

Le titre du lien auquel démarrer l’énumération.

alto

Le titre du lien auquel arrêter l’énumération.

alprefix

Rechercher tous les titres liés commençant par cette valeur.

alunique

Afficher uniquement les titres liés distincts. Impossible à utiliser avec alprop=ids. Utilisé avec un générateur, produit les pages cible au lieu des pages source.

alprop

Quelles informations inclure :

ids
Ajoute l’ID de la page de liaison (impossible à utiliser avec alunique).
title
Ajoute le titre du lien.
Valeurs (séparées par |) : ids, title
Par défaut : title
alnamespace

L’espace de noms à énumérer.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
allimit

Combien d’éléments renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
aldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Lister les titres liés, y compris les manquants, avec les IDs des pages d’où ils proviennent, en démarrant à B.
api.php?action=query&list=alllinks&alfrom=B&alprop=ids|title
Lister les titres liés uniques
api.php?action=query&list=alllinks&alunique=&alfrom=B
Obtient tous les titres liés, en marquant les manquants
api.php?action=query&generator=alllinks&galunique=&galfrom=B
Obtient les pages contenant les liens
api.php?action=query&generator=alllinks&galfrom=B

list=allpages (ap)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Énumérer toutes les pages séquentiellement dans un espace de noms donné.

Paramètres :
apfrom

Le titre de la page depuis lequel commencer l’énumération.

apcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

apto

Le titre de la page auquel stopper l’énumération.

apprefix

Rechercher tous les titres de page qui commencent par cette valeur.

apnamespace

L’espace de noms à énumérer.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
apfilterredir

Quelles pages lister.

Une valeur : all, redirects, nonredirects
Par défaut : all
apminsize

Limiter aux pages avec au moins ce nombre d’octets.

apmaxsize

Limiter aux pages avec au plus ce nombre d’octets.

apprtype

Limiter aux pages protégées uniquement.

Valeurs (séparées par |) : edit, move, upload
apprlevel

Filtrer les protections basées sur le niveau de protection (doit être utilisé avec le paramètre apprtype=).

Valeurs (séparées par |) : Peut être vide, ou autoconfirmed, sysop
apprfiltercascade

Filtrer les protections d’après leur cascade (ignoré si apprtype n’est pas positionné).

Une valeur : cascading, noncascading, all
Par défaut : all
aplimit

Combien de pages renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
apdir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
apfilterlanglinks

Filtrer si une page a des liens de langue. Noter que cela ne prend pas en compte les liens de langue ajoutés par des extensions.

Une valeur : withlanglinks, withoutlanglinks, all
Par défaut : all
apprexpiry

Quelle expiration de protection sur laquelle filtrer la page :

indefinite
N’obtenir que les pages avec une expiration de protection infinie.
definite
N’obtenir que les pages avec une expiration de protection définie (spécifique).
all
Obtenir toutes les pages avec une expiration de protection.
Une valeur : indefinite, definite, all
Par défaut : all
Exemples :
Afficher une liste des pages commençant par la lettre B.
api.php?action=query&list=allpages&apfrom=B
Afficher l’information sur 4 pages commençant par la lettre T.
api.php?action=query&generator=allpages&gaplimit=4&gapfrom=T&prop=info
Afficher le contenu des 2 premières pages hors redirections commençant par Re.
api.php?action=query&generator=allpages&gaplimit=2&gapfilterredir=nonredirects&gapfrom=Re&prop=revisions&rvprop=content

list=allredirects (ar)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les redirections vers un espace de noms.

Paramètres :
arcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

arfrom

Le titre de la redirection auquel démarrer l’énumération.

arto

Le titre de la redirection auquel arrêter l’énumération.

arprefix

Rechercher toutes les pages cible commençant par cette valeur.

arunique

Afficher uniquement les pages cibles distinctes. Impossible à utiliser avec arprop=ids|fragment|interwiki. Utilisé avec un générateur, produit les pages cible au lieu des pages source.

arprop

Quelles informations inclure :

ids
Ajoute l’ID de la page de redirection (impossible à utiliser avec arunique).
title
Ajoute le titre de la redirection.
fragment
Ajoute le fragment de la redirection, s’il y en a un (impossible à utiliser avec arunique).
interwiki
Ajoute le préfixe interwiki de la redirection, s’il y en a un (impossible à utiliser avec arunique).
Valeurs (séparées par |) : ids, title, fragment, interwiki
Par défaut : title
arnamespace

L’espace de noms à énumérer.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
arlimit

Combien d’éléments renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
ardir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Lister les pages cible, y compris les manquantes, avec les IDs de page d’où ils proviennent, en commençant à B.
api.php?action=query&list=allredirects&arfrom=B&arprop=ids|title
Lister les pages cible unique
api.php?action=query&list=allredirects&arunique=&arfrom=B
Obtient toutes les pages cible, en marquant les manquantes
api.php?action=query&generator=allredirects&garunique=&garfrom=B
Obtient les pages contenant les redirections
api.php?action=query&generator=allredirects&garfrom=B

list=alltransclusions (at)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les transclusions (pages intégrées en utilisant {{x}}), y compris les inexistantes.

Paramètres :
atcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

atfrom

Le titre de la transclusion depuis lequel commencer l’énumération.

atto

Le titre de la transclusion auquel arrêter l’énumération.

atprefix

Rechercher tous les titres inclus qui commencent par cette valeur.

atunique

Afficher uniquement les titres inclus. Impossible à utiliser avec atprop=ids. Utilisé avec un générateur, produit les pages cible plutôt que les pages source.

atprop

Quelles informations inclure :

ids
Ajoute l’ID de la page incluse (impossible à utiliser avec atunique).
title
Ajoute le titre de la transclusion.
Valeurs (séparées par |) : ids, title
Par défaut : title
atnamespace

L’espace de noms à énumérer.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 10
atlimit

Combien d’éléments renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
atdir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Lister les titres inclus, y compris les manquants, avec les IDs des pages d’où ils viennent, en commençant à B.
api.php?action=query&list=alltransclusions&atfrom=B&atprop=ids|title
Lister les titres inclus uniques
api.php?action=query&list=alltransclusions&atunique=&atfrom=B
Obtient tous les titres inclus, en marquant les manquants
api.php?action=query&generator=alltransclusions&gatunique=&gatfrom=B
Obtient les pages contenant des transclusions
api.php?action=query&generator=alltransclusions&gatfrom=B

list=allusers (au)

  • Ce module nécessite des droits de lecture.

Énumérer tous les utilisateurs enregistrés.

Paramètres :
aufrom

Le nom d’utilisateur auquel démarrer l’énumération.

auto

Le nom d’utilisateur auquel stopper l’énumération.

auprefix

Rechercher tous les utilisateurs commençant par cette valeur.

audir

Direction du tri.

Une valeur : ascending, descending
Par défaut : ascending
augroup

Inclure uniquement les utilisateurs dans les groupes donnés.

Valeurs (séparées par |) : bot, sysop, bureaucrat, WikiSysop
auexcludegroup

Exclure les utilisateurs dans les groupes donnés.

Valeurs (séparées par |) : bot, sysop, bureaucrat, WikiSysop
aurights

Inclure uniquement les utilisateurs avec les droits indiqués. Ne comprend pas les droits accordés par des groupes implicites ou auto-promus comme *, user ou autoconfirmed.

Valeurs (séparées par |) : apihighlimits, applychangetags, autoconfirmed, autopatrol, bigdelete, block, blockemail, bot, browsearchive, changetags, createaccount, createpage, createtalk, delete, deletedhistory, deletedtext, deletelogentry, deleterevision, edit, editcontentmodel, editinterface, editprotected, editmyoptions, editmyprivateinfo, editmyusercss, editmyuserjs, editmywatchlist, editsemiprotected, editusercssjs, editusercss, edituserjs, hideuser, import, importupload, ipblock-exempt, managechangetags, markbotedits, mergehistory, minoredit, move, movefile, move-categorypages, move-rootuserpages, move-subpages, nominornewtalk, noratelimit, override-export-depth, pagelang, passwordreset, patrol, patrolmarks, protect, proxyunbannable, purge, read, reupload, reupload-own, reupload-shared, rollback, sendemail, siteadmin, suppressionlog, suppressredirect, suppressrevision, unblockself, undelete, unwatchedpages, upload, upload_by_url, userrights, userrights-interwiki, viewmyprivateinfo, viewmywatchlist, viewsuppressed, writeapi
Le nombre maximal de valeurs est 50 (500 pour les robots).
auprop

Quelles informations inclure :

blockinfo
Ajoute l’information sur le bloc actuel d’un utilisateur.
groups
Liste des groupes auxquels appartient l’utilisateur. Cela utilise beaucoup de ressources du serveur et peut renvoyer moins de résultats que la limite.
implicitgroups
Liste tous les groupes auxquels l’utilisateur est affecté automatiquement.
rights
Liste les droits qu’à l’utilisateur.
editcount
Ajoute le compteur de modifications de l’utilisateur.
registration
Ajoute l’horodatage de l’inscription de l’utilisateur, s’il est disponible (peut être vide).
Valeurs (séparées par |) : blockinfo, groups, implicitgroups, rights, editcount, registration
aulimit

Combien de noms d’utilisateur renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
auwitheditsonly

Ne lister que les utilisateurs qui ont fait des modifications.

auactiveusers

Lister uniquement les utilisateurs actifs durant les 30 derniers jours.

Exemple :
Lister les utilisateurs en commençant à Y.
api.php?action=query&list=allusers&aufrom=Y
  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui ont un lien vers la page donnée.

Paramètres :
bltitle

Titre à rechercher. Impossible à utiliser avec blpageid.

blpageid

ID de la page à chercher. Impossible à utiliser avec bltitle.

blcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

blnamespace

L’espace de noms à énumérer.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
bldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
blfilterredir

Comment filtrer les redirections. Si positionné à nonredirects quand blredirect est activé, cela ne s’applique qu’au second niveau.

Une valeur : all, redirects, nonredirects
Par défaut : all
bllimit

Combien de pages renvoyer au total. Si blredirect est activé, la limite s’applique à chaque niveau séparément (ce qui signifie jusqu’à 2 * limite résultats peut être retourné).

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
blredirect

Si le lien vers une page est une redirection, trouver toutes les pages qui ont un lien vers cette redirection aussi. La limite maximale est divisée par deux.

Exemples :
Afficher les liens vers Main page.
api.php?action=query&list=backlinks&bltitle=Main%20Page
Obtenir des informations sur les pages ayant un lien vers Main page.
api.php?action=query&generator=backlinks&gbltitle=Main%20Page&prop=info

list=blocks (bk)

  • Ce module nécessite des droits de lecture.

Lister tous les utilisateurs et les adresses IP bloqués.

Paramètres :
bkstart

L’horodatage auquel démarrer l’énumération.

bkend

L’horodatage auquel arrêter l’énumération.

bkdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : bkstart doit être avant bkend.
older
Lister les nouveaux en premier (par défaut). Note : bkstart doit être postérieur à bkend.
Une valeur : newer, older
Par défaut : older
bkids

Liste des IDs de bloc à lister (facultatif).

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
bkusers

Liste des utilisateurs à rechercher (facultatif).

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
bkip

Obtenir tous les blocs s’appliquant à cette adresse IP ou à cette plage CIDR, y compris les blocs de plage. Impossible à utiliser avec bkusers. Les plages CIDR plus larges que IPv4/16 ou IPv6/19 ne sont pas acceptées.

bklimit

Le nombre maximal de blocs à lister.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
bkprop

Quelles propriétés obtenir :

id
Ajoute l’ID du blocage.
user
Ajoute le nom de l’utilisateur bloqué.
userid
Ajoute l’ID de l’utilisateur bloqué.
by
Ajoute le nom de l’utilisateur ayant bloqué.
byid
Ajoute l’ID de l’utilisateur ayant bloqué.
timestamp
Ajoute l’horodatage du blocage.
expiry
Ajoute l’horodatage d’expiration du blocage.
reason
Ajoute le motif du blocage.
range
Ajoute la plage d’adresses IP affectée par le blocage.
flags
Marque le bannissement avec (autoblock, anononly, etc.).
Valeurs (séparées par |) : id, user, userid, by, byid, timestamp, expiry, reason, range, flags
Par défaut : id|user|by|timestamp|expiry|reason|flags
bkshow

Afficher uniquement les éléments correspondant à ces critères. Par exemple, pour voir uniquement les blocages infinis sur les adresses IP, mettre bkshow=ip|!temp.

Valeurs (séparées par |) : account, !account, temp, !temp, ip, !ip, range, !range
bkcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Lister les blocages
api.php?action=query&list=blocks
Lister les blocages des utilisateurs Alice et Bob.
api.php?action=query&list=blocks&bkusers=Alice|Bob

list=categorymembers (cm)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les pages d’une catégorie donnée.

Paramètres :
cmtitle

Quelle catégorie énumérer (obligatoire). Doit comprendre le préfixe Catégorie:. Impossible à utiliser avec cmpageid.

cmpageid

ID de la page de la catégorie à énumérer. Impossible à utiliser avec cmtitle.

cmprop

Quelles informations inclure :

ids
Ajoute l’ID de la page.
title
Ajoute le titre et l’ID de l’espace de noms de la page.
sortkey
Ajoute la clé de tri utilisée pour trier dans la catégorie (chaîne hexadécimale).
sortkeyprefix
Ajoute le préfixe de la clé de tri utilisé pour trier dans la catégorie (partie lisible de la clé de tri).
type
Ajoute le type dans lequel a été catégorisée la page (page, sous-catégorie ou fichier).
timestamp
Ajoute l’horodatage de l’inclusion de la page.
Valeurs (séparées par |) : ids, title, sortkey, sortkeyprefix, type, timestamp
Par défaut : ids|title
cmnamespace

Inclure uniquement les pages dans ces espaces de nom. Remarquez que cmtype=subcat ou cmtype=file peuvent être utilisés à la place de cmnamespace=14 ou 6.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
cmtype

Quel type de membres de la catégorie inclure. Ignoré quand cmsort=timestamp est positionné.

Valeurs (séparées par |) : page, subcat, file
Par défaut : page|subcat|file
cmcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

cmlimit

Le nombre maximal de pages à renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
cmsort

Propriété par laquelle trier.

Une valeur : sortkey, timestamp
Par défaut : sortkey
cmdir

Dans quelle direction trier.

Une valeur : asc, desc, ascending, descending, newer, older
Par défaut : ascending
cmstart

Horodatage auquel démarrer la liste. Peut être utilisé uniquement avec cmsort=timestamp.

cmend

Horodatage auquel terminer la liste. Peut être utilisé uniquement avec cmsort=timestamp.

cmstarthexsortkey

Clé de tri à laquelle démarrer le listage, telle que renvoyée par cmprop=sortkey. Utilisable uniquement avec cmsort=sortkey.

cmendhexsortkey

Clé de tri à laquelle arrêter le listage, telle que renvoyée par cmprop=sortkey. Utilisable uniquement avec cmsort=sortkey.

cmstartsortkeyprefix

Préfixe de la clé de tri à laquelle démarrer le listage. Utilisable uniquement avec cmsort=sortkey. Écrase cmstarthexsortkey.

cmendsortkeyprefix

Préfixe de la clé de tri AVANT laquelle se termine le listage (et non pas à, si cette valeur existe elle ne sera pas incluse !). Utilisable uniquement avec cmsort=sortkey. Écrase cmendhexsortkey.

cmstartsortkey
Obsolète.

Utiliser plutôt cmstarthexsortkey.

cmendsortkey
Obsolète.

Utiliser plutôt cmendhexsortkey.

Exemples :
Obtenir les 10 premières pages de Category:Physics.
api.php?action=query&list=categorymembers&cmtitle=Category:Physics
Obtenir l’information sur les 10 premières pages de Category:Physics.
api.php?action=query&generator=categorymembers&gcmtitle=Category:Physics&prop=info

list=deletedrevs (dr)

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Lister les révisions supprimées.

Opère selon trois modes :

  1. Lister les révisions supprimées pour les titres donnés, triées par horodatage.
  2. Lister les contributions supprimées pour l’utilisateur donné, triées par horodatage (pas de titres spécifiés).
  3. Lister toutes les révisions supprimées dans l’espace de noms donné, triées par titre et horodatage (aucun titre spécifié, druser non positionné).

Certains paramètres ne s’appliquent qu’à certains modes et sont ignorés dans les autres.

Paramètres :
drstart

L’horodatage auquel démarrer l’énumération.

Modes : 1, 2
drend

L’horodatage auquel arrêter l’énumération.

Modes : 1, 2
drdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : drstart doit être avant drend.
older
Lister les nouveaux en premier (par défaut). Note : drstart doit être postérieur à drend.
Modes : 1, 3
Une valeur : newer, older
Par défaut : older
drfrom

Démarrer la liste à ce titre.

Mode : 3
drto

Arrêter la liste à ce titre.

Mode : 3
drprefix

Rechercher tous les titres de page commençant par cette valeur.

Mode : 3
drunique

Lister uniquement une révision pour chaque page.

Mode : 3
drnamespace

Lister uniquement les pages dans cet espace de noms.

Mode : 3
Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
drtag

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

druser

Lister uniquement les révisions par cet utilisateur.

drexcludeuser

Ne pas lister les révisions par cet utilisateur.

drprop

Quelles propriétés obtenir :

revid
Ajoute l’ID de la révision supprimée.
parentid
Ajoute l’ID de la révision précédente de la page.
user
Ajoute l’utilisateur ayant fait la révision.
userid
Ajoute l’ID de l’utilisateur qui a fait la révision.
comment
Ajoute le commentaire de la révision.
parsedcomment
Ajoute le commentaire analysé de la révision.
minor
Marque si la révision est mineure.
len
Ajoute la longueur (en octets) de la révision.
sha1
Ajoute le SHA-1 (base 16) de la révision.
content
Ajoute le contenu de la révision.
token
Obsolète. Fournit le jeton de modification.
tags
Balises pour la révision.
Valeurs (séparées par |) : revid, parentid, user, userid, comment, parsedcomment, minor, len, sha1, content, token, tags
Par défaut : user|comment
drlimit

Le nombre maximal de révisions à lister.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
drcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Lister les dernières révisions supprimées de des pages Main Page et Talk:Main Page, avec le contenu (mode 1).
api.php?action=query&list=deletedrevs&titles=Main%20Page|Talk:Main%20Page&drprop=user|comment|content
Lister les 50 dernières contributions de Bob supprimées (mode 2).
api.php?action=query&list=deletedrevs&druser=Bob&drlimit=50
Lister les 50 premières révisions supprimées dans l’espace de noms principal (mode 3)
api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50
Lister les 50 premières pages supprimées dans l’espace de noms Discussion (mode 3).
api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50&drnamespace=1&drunique=

list=embeddedin (ei)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui incluent (par transclusion) le titre donné.

Paramètres :
eititle

Titre à rechercher. Impossible à utiliser avec eipageid.

eipageid

ID de la page à rechercher. Impossible à utiliser avec eititle.

eicontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

einamespace

L’espace de noms à énumérer.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
eidir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
eifilterredir

Comment filtrer les redirections.

Une valeur : all, redirects, nonredirects
Par défaut : all
eilimit

Combien de pages renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
Exemples :
Afficher les pages incluant Template:Stub.
api.php?action=query&list=embeddedin&eititle=Template:Stub
Obteir des informations sur les pages incluant Template:Stub.
api.php?action=query&generator=embeddedin&geititle=Template:Stub&prop=info

list=exturlusage (eu)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Énumérer les pages contenant une URL donnée.

Paramètres :
euprop

Quelles informations inclure :

ids
Ajoute l’ID de la page.
title
Ajoute le titre et l’ID de l’espace de noms de la page.
url
Ajoute l’URL utilisée dans la page.
Valeurs (séparées par |) : ids, title, url
Par défaut : ids|title|url
euoffset

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

euprotocol

Protocole de l’URL. Si vide et que euquery est rempli, le protocole est http. Le laisser avec euquery vide pour lister tous les liens externes.

Une valeur : Peut être vide, ou bitcoin, ftp, ftps, geo, git, gopher, http, https, irc, ircs, magnet, mailto, mms, news, nntp, redis, sftp, sip, sips, sms, ssh, svn, tel, telnet, urn, worldwind, xmpp
Par défaut : (vide)
euquery

Rechercher une chaîne sans protocole. Voyez Special:LinkSearch. Le laisser vide liste tous les liens externes.

eunamespace

Les espaces de nom à énumérer.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
eulimit

Combien de pages renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
euexpandurl

Étendre les URLs relatives au protocole avec le protocole canonique.

list=filearchive (fa)

  • Ce module nécessite des droits de lecture.

Énumérer séquentiellement tous les fichiers supprimés.

Paramètres :
fafrom

Le titre de l’image auquel démarrer l’énumération.

fato

Le titre de l’image auquel arrêter l’énumération.

faprefix

Rechercher tous les titres d’image qui commencent par cette valeur.

fadir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
fasha1

Hachage SHA1 de l’image. Écrase fasha1base36.

fasha1base36

Hachage SHA1 de l’image en base 36 (utilisé dans MédiaWiki).

faprop

Quelle information obtenir sur l’image :

sha1
Ajoute le hachage SHA-1 pour l’image.
timestamp
Ajoute l÷’horodatage pour la version téléchargée.
user
Ajoute l’utilisateur qui a téléchargé la version de l’image.
size
Ajoute la taille de l’image en octets et la hauteur, la largeur et le nombre de page (si c’est applicable).
dimensions
Alias pour la taille.
description
Ajoute la description de la version de l’image.
parseddescription
Analyser la description de la version.
mime
Ajoute le MIME de l’image.
mediatype
Ajoute le type de média de l’image.
metadata
Liste les métadonnées Exif pour la version de l’image.
bitdepth
Ajoute la profondeur de bit de la version.
archivename
Ajoute le nom de fichier de la version d’archive pour les versions autres que la dernière.
Valeurs (séparées par |) : sha1, timestamp, user, size, dimensions, description, parseddescription, mime, mediatype, metadata, bitdepth, archivename
Par défaut : timestamp
falimit

Combien d’images renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
facontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemple :
Afficher une liste de tous les fichiers supprimés
api.php?action=query&list=filearchive

list=imageusage (iu)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui utilisent le titre de l’image donné.

Paramètres :
iutitle

Titre à rechercher. Impossible à utiliser avec iupageid.

iupageid

ID de la page à rechercher. Impossible à utiliser avec iutitle.

iucontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

iunamespace

L’espace de noms à énumérer.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
iudir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
iufilterredir

Comment filtrer les redirections. Si mis à nonredirects quand iuredirect est activé, cela ne s’appliquera qu’au second niveau.

Une valeur : all, redirects, nonredirects
Par défaut : all
iulimit

Combien de pages renvoyer au total. Si iuredirect est activé, la limite s’applique à chaque niveau séparément (ce qui veut dire que jusqu’à 2 * iulimit résultats peuvent être renvoyés).

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
iuredirect

Si le lien vers une page est une redirection, trouver toutes les pages qui ont aussi un lien vers cette redirection. La limite maximale est divisée par deux.

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui ont un lien vers le lien interwiki indiqué.

Peut être utilisé pour trouver tous les liens avec un préfixe, ou tous les liens vers un titre (avec un préfixe donné). N’utiliser aucun paramètre revient en pratique à « tous les liens interwiki ».

Paramètres :
iwblprefix

Préfixe pour l’interwiki.

iwbltitle

Lien interwiki à rechercher. Doit être utilisé avec iwblblprefix.

iwblcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

iwbllimit

Combien de pages renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
iwblprop

Quelles propriétés obtenir :

iwprefix
Ajoute le préfixe de l’interwiki.
iwtitle
Ajoute le titre de l’interwiki.
Valeurs (séparées par |) : iwprefix, iwtitle
Par défaut : (vide)
iwbldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending
  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Trouver toutes les pages qui ont un lien vers le lien de langue indiqué.

Peut être utilisé pour trouver tous les liens avec un code de langue, ou tous les liens vers un titre (avec une langue donnée). N’utiliser aucun paramètre revient à « tous les liens de langue ».

Notez que cela peut ne pas prendre en compte les liens de langue ajoutés par les extensions.

Paramètres :
lbllang

Langue pour le lien de langue.

lbltitle

Lien interlangue à rechercher. Doit être utilisé avec lbllang.

lblcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

lbllimit

Combien de pages renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
lblprop

Quelles propriétés obtenir :

lllang
Ajoute le code de langue du lien de langue.
lltitle
Ajoute le titre du lien de langue.
Valeurs (séparées par |) : lllang, lltitle
Par défaut : (vide)
lbldir

La direction dans laquelle lister.

Une valeur : ascending, descending
Par défaut : ascending

list=logevents (le)

  • Ce module nécessite des droits de lecture.

Obtenir des événements des journaux.

Paramètres :
leprop

Quelles propriétés obtenir :

ids
Ajoute l’ID de l’événement.
title
Ajoute le titre de la page pour l’événement.
type
Ajoute le type de l’événement.
user
Ajoute l’utilisateur responsable de l’événement.
userid
Ajoute l’ID de l’utilisateur responsable de l’événement.
timestamp
Ajoute l’horodatage de l’événement.
comment
Ajoute le commentaire de l’événement.
parsedcomment
Ajoute le commentaire analysé de l’événement.
details
Liste les détails supplémentaires sur l’événement.
tags
Liste les balises de l’événement.
Valeurs (séparées par |) : ids, title, type, user, userid, timestamp, comment, parsedcomment, details, tags
Par défaut : ids|title|type|user|timestamp|comment|details
letype

Filtrer les entrées du journal à ce seul type.

Une valeur : Peut être vide, ou block, protect, rights, delete, upload, move, import, patrol, merge, suppress, tag, managetags, newusers
leaction

Filtrer les actions du journal à cette seule action. Écrase letype. Des actions avec une astérisque de la forme letype sont autorisées pour spécifier n’importe quelle chaîne à la place de l’astérisque.

Une valeur : protect/protect, protect/modify, protect/unprotect, protect/move_prot, move/move, move/move_redir, delete/delete, delete/restore, delete/revision, delete/event, suppress/revision, suppress/event, suppress/delete, patrol/patrol, rights/rights, rights/autopromote, upload/upload, upload/overwrite, upload/revert, merge/merge, tag/update, managetags/create, managetags/delete, managetags/activate, managetags/deactivate, block/block, block/unblock, block/reblock, suppress/block, suppress/reblock, import/upload, import/interwiki, newusers/newusers, newusers/create, newusers/create2, newusers/byemail, newusers/autocreate
lestart

L’horodatage auquel démarrer l’énumération.

leend

L’horodatage auquel arrêter l’énumération.

ledir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : lestart doit être avant leend.
older
Lister les nouveaux en premier (par défaut). Note : lestart doit être postérieur à leend.
Une valeur : newer, older
Par défaut : older
leuser

Restreindre aux entrées générées par l’utilisateur spécifié.

letitle

Restreindre aux entrées associées à une page donnée.

lenamespace

Restreindre aux entrées dans l’espace de nom spécifié.

Une valeur : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
leprefix

Restreindre aux entrées commençant par ce préfixe.

letag

Lister seulement les entrées ayant cette balise.

lelimit

Combien d'entrées renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
lecontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemple :
Liste les entrées de journal récentes.
api.php?action=query&list=logevents

list=pagepropnames (ppn)

  • Ce module nécessite des droits de lecture.

Lister les noms de toutes les propriétés de page utilisées sur le wiki.

Paramètres :
ppncontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

ppnlimit

Le nombre maximal de noms à renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
Exemple :
Obtenir les 10 premiers noms de propriété.
api.php?action=query&list=pagepropnames

list=pageswithprop (pwp)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister toutes les pages utilisant une propriété de page donnée.

Paramètres :
pwppropname

Propriété de page pour laquelle énumérer les pages.

Ce paramètre est obligatoire.
pwpprop

Quelles informations inclure :

ids
Ajoute l’ID de la page.
title
Ajoute le titre et l’ID de l’espace de noms de la page.
value
Ajoute la valeur de la propriété de page.
Valeurs (séparées par |) : ids, title, value
Par défaut : ids|title
pwpcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

pwplimit

Le nombre maximal de pages à renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
pwpdir

Dans quelle direction trier.

Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Lister les 10 premières pages en utilisant {{DISPLAYTITLE:}}.
api.php?action=query&list=pageswithprop&pwppropname=displaytitle&pwpprop=ids|title|value
Obtenir des informations sur les 10 premières pages utilisant __NOTOC__.
api.php?action=query&generator=pageswithprop&gpwppropname=notoc&prop=info

list=prefixsearch (ps)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Effectuer une recherche de préfixe sur les titres de page.

Paramètres :
pssearch

Chaîne de recherche.

Ce paramètre est obligatoire.
psnamespace

Espaces de nom à rechercher.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
pslimit

Nombre maximal de résultats à renvoyer.

Pas plus de 100 autorisé (200 pour les robots).
Par défaut : 10
psoffset

Nombre de résultats à sauter.

Par défaut : 0
Exemple :
Rechercher les titres de page commençant par meaning.
api.php?action=query&list=prefixsearch&pssearch=meaning

list=protectedtitles (pt)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Lister tous les titres protégés en création.

Paramètres :
ptnamespace

Lister uniquement les titres dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
ptlevel

Lister uniquement les titres avec ces niveaux de protection.

Valeurs (séparées par |) : autoconfirmed, sysop
ptlimit

Combien de pages renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
ptdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : ptstart doit être avant ptend.
older
Lister les nouveaux en premier (par défaut). Note : ptstart doit être postérieur à ptend.
Une valeur : newer, older
Par défaut : older
ptstart

Démarrer la liste à cet horodatage de protection.

ptend

Arrêter la liste à cet horodatage de protection.

ptprop

Quelles propriétés obtenir :

timestamp
Ajoute l’horodatage de l’ajout de la protection.
user
Ajoute l’utilisateur ayant ajouté la protection.
userid
Ajoute l’ID de l’utilisateur ayant ajouté la protection.
comment
Ajoute le commentaire de la protection.
parsedcomment
Ajoute le commentaire analysé de la protection.
expiry
Ajoute l’horodatage de levée de la protection.
level
Ajoute le niveau de protection.
Valeurs (séparées par |) : timestamp, user, userid, comment, parsedcomment, expiry, level
Par défaut : timestamp|level
ptcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Lister les titres protégés
api.php?action=query&list=protectedtitles
Trouver les liens vers les titres protégés dans l’espace de noms principal
api.php?action=query&generator=protectedtitles&gptnamespace=0&prop=linkshere

list=querypage (qp)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Obtenir une liste fournie par une page spéciale basée sur QueryPage

Paramètres :
qppage

Le nom de la page spéciale. Remarque, ce nom est sensible à la casse.

Ce paramètre est obligatoire.
Une valeur : Ancientpages, BrokenRedirects, Deadendpages, DoubleRedirects, ListDuplicatedFiles, Listredirects, Lonelypages, Longpages, MediaStatistics, Mostcategories, Mostimages, Mostinterwikis, Mostlinkedcategories, Mostlinkedtemplates, Mostlinked, Mostrevisions, Fewestrevisions, Shortpages, Uncategorizedcategories, Uncategorizedpages, Uncategorizedimages, Uncategorizedtemplates, Unusedcategories, Unusedimages, Wantedcategories, Wantedfiles, Wantedpages, Wantedtemplates, Unwatchedpages, Unusedtemplates, Withoutinterwiki
qpoffset

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Par défaut : 0
qplimit

Nombre de résultats à renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10

list=random (rn)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Obtenir un ensemble de pages au hasard.

Les pages sont listées dans un ordre prédéterminé, seul le point de départ est aléatoire. Par exemple, cela signifie que si la première page dans la liste est Accueil, la seconde sera toujours Liste des singes de fiction, la troisième Liste de personnes figurant sur les timbres de Vanuatu, etc.

Si le nombre de page dans l’espace de nom est inférieur à rnlimit, moins de pages seront renvoyées. La même page ne sera jamais renvoyée deux fois.

Paramètres :
rnnamespace

Renvoyer seulement des pages de ces espaces de noms.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
rnlimit

Limite sur le nombre de pages aléatoires renvoyées.

Pas plus de 10 autorisé (20 pour les robots).
Par défaut : 1
rnredirect

Charger une redirection aléatoire plutôt qu’une page aléatoire.

Exemples :
Obtenir deux pages aléatoires de l’espace principal
api.php?action=query&list=random&rnnamespace=0&rnlimit=2
Renvoyer les informations de la page sur deux pages au hasard de l’espace de noms principal
api.php?action=query&generator=random&grnnamespace=0&grnlimit=2&prop=info

list=recentchanges (rc)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Énumérer les modifications récentes.

Paramètres :
rcstart

L’horodatage auquel démarrer l’énumération.

rcend

L’horodatage auquel arrêter l’énumération.

rcdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : rcstart doit être avant rcend.
older
Lister les nouveaux en premier (par défaut). Note : rcstart doit être postérieur à rcend.
Une valeur : newer, older
Par défaut : older
rcnamespace

Filtrer les modifications uniquement sur ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
rcuser

Lister uniquement les modifications par cet utilisateur.

rcexcludeuser

Ne pas lister les modifications par cet utilisateur.

rctag

Lister uniquement les modifications marquées avec cette balise.

rcprop

Inclure des informations supplémentaires :

user
Ajoute l’utilisateur responsable de la modification et marque si c’est une adresse IP.
userid
Ajoute l’ID de l’utilisateur responsable de la modification.
comment
Ajoute le commentaire de la modification.
parsedcomment
Ajoute le commentaire analysé pour la modification.
flags
Ajoute les balises de la modification.
timestamp
Ajoute l’horodatage de la modification.
title
Ajoute le titre de la page modifiée.
ids
Ajoute l’ID de la page, l’ID des modifications récentes et l’ID de l’ancienne et la nouvelle révisions.
sizes
Ajoute l’ancienne et la nouvelle tailles de la page en octets.
redirect
Marque la modification si la page est une redirection.
patrolled
Marque les modifications patrouillables comme patrouillées ou non.
loginfo
Ajoute les informations du journal (Id du journal, type de trace, etc.) aux entrées du journal.
tags
Liste les balises de l’entrée.
sha1
Ajoute la somme de contrôle du contenu pour les entrées associées à une révision.
Valeurs (séparées par |) : user, userid, comment, parsedcomment, flags, timestamp, title, ids, sizes, redirect, patrolled, loginfo, tags, sha1
Par défaut : title|timestamp|ids
rctoken
Obsolète.

Utiliser plutôt action=query&meta=tokens.

Valeurs (séparées par |) : patrol
rcshow

Afficher uniquement les éléments correspondant à ces critères. Par exemple, pour voir uniquement les modifications mineures par des utilisateurs connectés, mettre rcshow=minor|!anon.

Valeurs (séparées par |) : minor, !minor, bot, !bot, anon, !anon, redirect, !redirect, patrolled, !patrolled, unpatrolled
rclimit

Combien de modifications renvoyer au total.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
rctype

Quels types de modification afficher.

Valeurs (séparées par |) : edit, external, new, log
Par défaut : edit|new|log
rctoponly

Lister uniquement les modifications qui sont de la dernière révision.

rccontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Lister les modifications récentes
api.php?action=query&list=recentchanges
Obtenir l’information de page sur les modifications récentes non patrouillées
api.php?action=query&generator=recentchanges&grcshow=!patrolled&prop=info

list=search (sr)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Effectuer une recherche en texte intégral.

Paramètres :
srsearch

Rechercher les titres (ou le contenu) de toutes les pages ayant cette valeur.

Ce paramètre est obligatoire.
srnamespace

Rechercher uniquement dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Par défaut : 0
srwhat

Quel type de recherche effectuer.

Une valeur : title, text, nearmatch
srinfo

Quelles métadonnées renvoyer.

Valeurs (séparées par |) : totalhits, suggestion
Par défaut : totalhits|suggestion
srprop

Quelles propriétés renvoyer :

size
Ajoute la taille de la page en octets.
wordcount
Ajoute le nombre de mots de la page.
timestamp
Ajoute l’horodatage de la dernière modification de la page.
snippet
Ajoute un extrait analysé de la page.
titlesnippet
Ajoute un extrait analysé du titre de la page.
redirectsnippet
Ajoute un extrait analysé du titre de la redirection.
redirecttitle
Ajoute le titre de la redirection correspondante.
sectionsnippet
Ajoute un extrait analysé du titre de la section correspondante.
sectiontitle
Ajoute le titre de la section correspondante.
score
Obsolète et ignoré.
hasrelated
Obsolète et ignoré.
Valeurs (séparées par |) : size, wordcount, timestamp, score, snippet, titlesnippet, redirecttitle, redirectsnippet, sectiontitle, sectionsnippet, hasrelated
Par défaut : size|wordcount|timestamp|snippet
sroffset

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Par défaut : 0
srlimit

Combien de pages renvoyer au total.

Pas plus de 50 autorisé (500 pour les robots).
Par défaut : 10
srinterwiki

Inclure les résultats interwiki dans la recherche, s’ils sont disponibles.

Exemples :
Rechercher signification .
api.php?action=query&list=search&srsearch=meaning
Rechercher des textes pour signification.
api.php?action=query&list=search&srwhat=text&srsearch=meaning
Obtenir les informations sur les pages renvoyées par une recherche de signification.
api.php?action=query&generator=search&gsrsearch=meaning&prop=info

list=tags (tg)

  • Ce module nécessite des droits de lecture.

Lister les balises de modification.

Paramètres :
tgcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

tglimit

Le nombre maximal de balises à lister.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
tgprop

Quelles propriétés récupérer :

name
Ajoute le nom de la balise.
displayname
Ajoute le message système pour la balise.
description
Ajoute la description de la balise.
hitcount
Ajoute le nombre de révisions et d’entrées du journal qui ont cette balise.
defined
Indique si la balise est définie.
source
Obtient les sources de la balise, ce qui comprend extension pour les balises définies par une extension et manual pour les balises pouvant être appliquées manuellement par les utilisateurs.
active
Si la balise est encore appliquée.
Valeurs (séparées par |) : name, displayname, description, hitcount, defined, source, active
Par défaut : name

list=usercontribs (uc)

  • Ce module nécessite des droits de lecture.

Obtenir toutes les modifications par un utilisateur.

Paramètres :
uclimit

Le nombre maximal de contributions à renvoyer.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
ucstart

L’horodatage auquel démarrer le retour.

ucend

L’horodatage auquel arrêter le retour.

uccontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

ucuser

Les utilisateurs pour lesquels récupérer les contributions.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
ucuserprefix

Récupérer les contributions pour tous les utilisateurs dont les noms commencent par cette valeur. Écrase ucuser.

ucdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : ucstart doit être avant ucend.
older
Lister les nouveaux en premier (par défaut). Note : ucstart doit être postérieur à ucend.
Une valeur : newer, older
Par défaut : older
ucnamespace

Lister uniquement les contributions dans ces espaces de nom.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
ucprop

Inclure des informations supplémentaires:

ids
Ajoute l’ID de page et l’ID de révision.
title
Ajoute le titre et l’ID d’espace de noms de la page.
timestamp
Ajoute l’horodatage de la modification.
comment
Ajoute le commentaire de la modification.
parsedcomment
Ajoute le commentaire analysé de la modification.
size
Ajoute la nouvelle taille de la modification.
sizediff
Ajoute le delta de taille de la modification par rapport à son parent.
flags
Ajoute les marques de la modification.
patrolled
Marque les modifications patrouillées.
tags
Liste les balises de la modification.
Valeurs (séparées par |) : ids, title, timestamp, comment, parsedcomment, size, sizediff, flags, patrolled, tags
Par défaut : ids|title|timestamp|comment|size|flags
ucshow

Afficher uniquement les éléments correspondant à ces critères, par ex. les modifications non mineures uniquement : ucshow=!minor.

Si ucshow=patrolled ou ucshow=!patrolled est positionné, les révisions plus anciennes que $wgRCMaxAge (7776000 secondes) ne seront pas affichées.

Valeurs (séparées par |) : minor, !minor, patrolled, !patrolled, top, !top, new, !new
uctag

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

uctoponly
Obsolète.

Lister uniquement les modifications qui sont la dernière révision.

Exemples :
Afficher les contributions de l'utilisateur Exemple.
api.php?action=query&list=usercontribs&ucuser=Example
Afficher les contributions de toutes les adresses IP avec le préfixe 192.0.2..
api.php?action=query&list=usercontribs&ucuserprefix=192.0.2.

list=users (us)

  • Ce module nécessite des droits de lecture.

Obtenir des information sur une liste d’utilisateurs

Paramètres :
usprop

Quelles informations inclure :

blockinfo
Marque si l’utilisateur est bloqué, par qui, et pour quelle raison.
groups
Liste tous les groupes auquel appartient chaque utilisateur.
implicitgroups
Liste tous les groupes dont un utilisateur est automatiquement membre.
rights
Liste tous les droits qu’a un utilisateur.
editcount
Ajoute le compteur de modifications de l’utilisateur.
registration
Ajoute l’horodatage d’inscription de l’utilisateur.
emailable
Marque si l’utilisateur peut et veut recevoir des courriels via Special:Emailuser.
gender
Marque le sexe de l’utilisateur. Renvoie « male », « female », ou « unknown ».
Valeurs (séparées par |) : blockinfo, groups, implicitgroups, rights, editcount, registration, emailable, gender
ususers

Une liste des utilisateurs sur lesquels obtenir de l’information.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
ustoken
Obsolète.

Utiliser plutôt action=query&meta=tokens.

Valeurs (séparées par |) : userrights
Exemple :
Renvoyer des informations pour l'utilisateur Exemple.
api.php?action=query&list=users&ususers=Example&usprop=groups|editcount|gender

list=watchlist (wl)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Obtenir les modifications récentes des pages dans la liste de suivi de l’utilisateur actuel.

Paramètres :
wlallrev

Inclure les multiples révisions de la même page dans l’intervalle de temps fourni.

wlstart

L’horodatage auquel démarrer l’énumération.

wlend

L’horodatage auquel arrêter l’énumération.

wlnamespace

Filtrer les modifications aux seuls espaces de nom fournis.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
wluser

Lister uniquement les modifications par cet utilisateur.

wlexcludeuser

Ne pas lister les modifications faites par cet utilisateur.

wldir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : wlstart doit être avant wlend.
older
Lister les nouveaux en premier (par défaut). Note : wlstart doit être postérieur à wlend.
Une valeur : newer, older
Par défaut : older
wllimit

Combien de résultats au total renvoyer par demande.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
wlprop

Quels éléments supplémentaires obtenir :

ids
Ajoute les IDs de révision et de page.
title
Ajoute le titre de la page.
flags
Ajoute les marques de la modification.
user
Ajoute l’utilisateur ayant fait la modification.
userid
Ajoute l’ID de l’utilisateur ayant fait la modification.
comment
Ajoute le commentaire de la modification.
parsedcomment
Ajoute le commentaire analysé de la modification.
timestamp
Ajoute l’horodatage de la modification.
patrol
Marque les modifications patrouillées.
sizes
Ajoute les ancienne et nouvelle tailles de la page.
notificationtimestamp
Ajoute l’horodatage de quand l’utilisateur a été notifié de la modification la dernière fois.
loginfo
Ajoute l’information du journal quand c’est approprié.
Valeurs (séparées par |) : ids, title, flags, user, userid, comment, parsedcomment, timestamp, patrol, sizes, notificationtimestamp, loginfo
Par défaut : ids|title|flags
wlshow

Afficher uniquement les éléments qui correspondent à ces critères. Par exemple, pour voir uniquement les modifications mineures faites par des utilisateurs connectés, mettre wlshow=minor|!anon.

Valeurs (séparées par |) : minor, !minor, bot, !bot, anon, !anon, patrolled, !patrolled, unread, !unread
wltype

Quels types de modification afficher :

edit
Modifications de page normale.
external
Modifications externes.
new
Créations de page.
log
Entrées du journal.
Valeurs (séparées par |) : edit, external, new, log
Par défaut : edit|new|log
wlowner

Utilisé avec wltoken pour accéder à la liste de suivi d’un autre utilisateur.

wltoken

Un jeton de sécurité (disponible dans les préférences de l’utilsiateur) pour autoriser l’accès à la liste de suivi d&un autre utilisateur.

wlcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

Exemples :
Lister la révision de tête des pages récemment modifiées dans la liste de suivi de l’utilisateur actuel
api.php?action=query&list=watchlist
Chercher des informations supplémentaires sur la révision de tête des pages récemment modifiées de la liste de suivi de l’utilisateur actuel
api.php?action=query&list=watchlist&wlprop=ids|title|timestamp|user|comment
Chercher les informations sur toutes les modifications récentes des pages de la liste de suivi de l’utilisateur actuel
api.php?action=query&list=watchlist&wlallrev=&wlprop=ids|title|timestamp|user|comment
Chercher l’information de la page sur les pages récemment modifiées de la liste de suivi de l’utilisateur actuel
api.php?action=query&generator=watchlist&prop=info
Chercher l’information de la révision pour les modifications récentes des pages de la liste de suivi de l’utilisateur actuel
api.php?action=query&generator=watchlist&gwlallrev=&prop=revisions&rvprop=timestamp|user
Lister la révision de tête des pages récemment modifiées de la liste de suivi de l'utilisateur Exemple.
api.php?action=query&list=watchlist&wlowner=Example&wltoken=123ABC

list=watchlistraw (wr)

  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.

Obtenir toutes les pages de la liste de suivi de l’utilisateur actuel.

Paramètres :
wrcontinue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

wrnamespace

Lister uniquement les pages dans les espaces de nom fournis.

Valeurs (séparées par |) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
wrlimit

Combien de résultats renvoyer au total par requête.

Pas plus de 500 autorisé (5 000 pour les robots).
Par défaut : 10
wrprop

Quelles propriétés supplémentaires obtenir :

changed
Ajoute l’horodatage de la dernière notification de l’utilisateur à propos de la modification.
Valeurs (séparées par |) : changed
wrshow

Lister uniquement les éléments correspondant à ces critères.

Valeurs (séparées par |) : changed, !changed
wrowner

Utilisé avec wrtoken pour accéder à la liste de suivi d’un autre utilisateur.

wrtoken

Un jeton de sécurité (disponible dans les préférences de l’utilisateur) pour permettre l’accès à la liste de suivi d’un autre utilisateur.

wrdir

Dans quelle direction énumérer :

newer
Lister les plus anciens en premier. Note : wrstart doit être avant wrend.
older
Lister les nouveaux en premier (par défaut). Note : wrstart doit être postérieur à wrend.
Une valeur : ascending, descending
Par défaut : ascending
Exemples :
Lister les pages dans la liste de suivi de l’utilisateur actuel
api.php?action=query&list=watchlistraw
Chercher l’information sur les pages de la liste de suivi de l’utilisateur actuel
api.php?action=query&generator=watchlistraw&gwrshow=changed&prop=info

meta=allmessages (am)

  • Ce module nécessite des droits de lecture.

Renvoyer les messages depuis ce site.

Paramètres :
ammessages

Quels messages sortir. * (par défaut) signifie tous les messages.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
Par défaut : *
amprop

Quelles propriétés obtenir.

Valeurs (séparées par |) : default
amenableparser

Si positionné pour activer l’analyseur, traitera en avance le wikitexte du message (substitution des mots magiques, gestion des modèles, etc.).

amnocontent

Si positionné, ne pas inclure le contenu des messages dans la sortie.

amincludelocal

Inclure aussi les messages locaux, c’est-à-dire les messages qui n’existent pas dans le logiciel mais sous forme d’une page MediaWiki:. Cela liste toutes les pages MediaWiki:, donc aussi celles qui ne sont pas vraiment des messages, telles que Common.js.

amargs

Arguments à substituer dans le message.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
amfilter

Renvoyer uniquement les messages avec des noms contenant cette chaîne.

amcustomised

Renvoyer uniquement les messages dans cet état de personnalisation.

Une valeur : all, modified, unmodified
Par défaut : all
amlang

Renvoyer les messages dans cette langue.

amfrom

Renvoyer les messages commençant à ce message.

amto

Renvoyer les messages en terminant à ce message.

amtitle

Nom de page à utiliser comme contexte en analysant le message (pour l’option amenableparser).

amprefix

Renvoyer les messages avec ce préfixe.

Exemples :
Afficher les messages commençant par ipb-.
api.php?action=query&meta=allmessages&amprefix=ipb-
Afficher les messages august et mainpage en allemand.
api.php?action=query&meta=allmessages&ammessages=august|mainpage&amlang=de

meta=filerepoinfo (fri)

  • Ce module nécessite des droits de lecture.

Renvoyer les méta-informations sur les référentiels d’image configurés dans le wiki.

Paramètre :
friprop

Quelles propriétés du référentiel récupérer (il peut y en avoir plus de disponibles sur certains wikis) :

apiurl
URL de l’API du référentiel - utile pour obtenir les infos de l’image depuis l’hôte.
name
La clé du référentiel - utilisé par ex. dans les valeurs de retour de $wgForeignFileRepos et imageinfo.
displayname
Le nom lisible du wiki référentiel.
rooturl
URL racine des chemins d’image.
local
Si ce référentiel est le référentiel local ou non.
Valeurs (séparées par |) : name, displayname, rootUrl, local, url, thumbUrl, initialCapital, scriptDirUrl, scriptExtension, favicon
Par défaut : name|displayname|rootUrl|local|url|thumbUrl|initialCapital|scriptDirUrl|scriptExtension|favicon
Exemple :
Obtenir l’information sur les référentiels de fichier
api.php?action=query&meta=filerepoinfo&friprop=apiurl|name|displayname

meta=siteinfo (si)

  • Ce module nécessite des droits de lecture.

Renvoyer les informations générales sur le site.

Paramètres :
siprop

Quelles informations obtenir :

general
Information globale du système.
namespaces
Liste des espaces de nom déclarés et leur nom canonique.
namespacealiases
Liste des alias des espaces de nom déclarés.
specialpagealiases
Liste des alias des pages spéciales.
magicwords
Liste des mots magiques et leurs alias.
statistics
Renvoie les statistiques du site.
interwikimap
Renvoie la correspondance interwiki (éventuellement filtrée, éventuellement localisée en utilisant siinlanguagecode).
dbrepllag
Renvoie le serveur de base de donnée avec la plus grande latence de réplication.
usergroups
Renvoie les groupes utilisateur et les droits associés.
libraries
Renvoie les bibliothèques installées sur le wiki.
extensions
Renvoie les extensions installées sur le wiki.
fileextensions
Renvoie la liste des extensions de fichier autorisées au téléchargement.
rightsinfo
Renvoie l’information sur les droits du wiki (sa licence), si elle est disponible.
restrictions
Renvoie l’information sur les types de restriction disponibles (protection).
languages
Renvoie une liste des langues que supporte MédiaWiki (éventuellement localisé en utilisant siinlanguagecode).
skins
Renvoie une liste de tous les habillages activés (éventuellement localisé en utilisant siinlanguagecode, sinon dans la langue du contenu).
extensiontags
Renvoie une liste des balises d’extension de l’analyseur.
functionhooks
Renvoie une liste des accroches de fonction de l’analyseur.
showhooks
Renvoie une liste de toutes les accroches souscrites (contenu de $wgHooks).
variables
Renvoie une liste des IDs de variable.
protocols
Renvoie une liste des protocoles qui sont autorisés dans les liens externes.
defaultoptions
Renvoie les valeurs par défaut pour les préférences utilisateur.
Valeurs (séparées par |) : general, namespaces, namespacealiases, specialpagealiases, magicwords, interwikimap, dbrepllag, statistics, usergroups, libraries, extensions, fileextensions, rightsinfo, restrictions, languages, skins, extensiontags, functionhooks, showhooks, variables, protocols, defaultoptions
Par défaut : general
sifilteriw

Renvoyer uniquement les entrées locales ou uniquement les non locales de la correspondance interwiki.

Une valeur : local, !local
sishowalldb

Lister tous les serveurs de base de données, pas seulement celui avec la plus grande latence.

sinumberingroup

Liste le nombre d’utilisateurs dans les groupes.

siinlanguagecode

Code de langue pour les noms de langue localisés (du mieux possible) et les noms d’habillage.

meta=tokens

  • Ce module nécessite des droits de lecture.

Récupère les jetons pour les actions de modification de données.

Paramètre :
type

Types de jeton à demander.

Valeurs (séparées par |) : csrf, patrol, rollback, userrights, watch
Par défaut : csrf
Exemples :
Récupérer un jeton csrf (par défaut)
api.php?action=query&meta=tokens
Récupérer un jeton de suivi et un de patrouille
api.php?action=query&meta=tokens&type=watch|patrol

meta=userinfo (ui)

  • Ce module nécessite des droits de lecture.

Obtenir de l’information sur l’utilisateur courant.

Paramètre :
uiprop

Quelles informations inclure :

blockinfo
Marque si l’utilisateur actuel est bloqué, par qui, et pour quelle raison.
hasmsg
Ajoute une balise message si l’utilisateur actuel a des messages en cours.
groups
Liste tous les groupes auxquels appartient l’utilisateur actuel.
implicitgroups
Liste tous les groupes dont l’utilisateur actuel est automatiquement membre.
rights
Liste tous les droits qu’a l’utilisateur actuel.
changeablegroups
Liste les groupes pour lesquels l’utilisateur actuel peut ajouter ou supprimer.
options
Liste toutes les préférences qu’a défini l’utilisateur actuel.
preferencestoken
Obsolete. Obtient un jeton pour modifier les préférences de l’utilisateur actuel.
editcount
Ajoute le compteur de modifications de l’utilisateur actuel.
ratelimits
Liste toutes les limites de débit s’appliquant à l’utilisateur actuel.
realname
Ajoute le vrai nom de l’utilisateur actuel.
email
Ajoute l’adresse de courriel de l’utilisateur et sa date d’authentification.
acceptlang
Renvoie en écho l’entête Accept-Language envoyé par le client dans un format structuré.
registrationdate
Ajoute la date d’inscription de l’utilisateur.
unreadcount
Ajoute le compteur de pages non lues de la liste de suivi de l’utilisateur (au maximum 999 ; renvoie 1000+ s’il y en a plus).
Valeurs (séparées par |) : blockinfo, hasmsg, groups, implicitgroups, rights, changeablegroups, options, preferencestoken, editcount, ratelimits, email, realname, acceptlang, registrationdate, unreadcount
Exemples :
Obtenir de l’information sur l’utilisateur actuel
api.php?action=query&meta=userinfo
Obtenir des informations supplémentaires sur l’utilisateur actuel
api.php?action=query&meta=userinfo&uiprop=blockinfo|groups|rights|hasmsg

action=revisiondelete

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Supprimer et annuler la suppression des révisions.

Paramètres :
type

Type de suppression de révision en cours de traitement.

Ce paramètre est obligatoire.
Une valeur : revision, archive, oldimage, filearchive, logging
target

Titre de page pour la suppression de révision, s’il est nécessaire pour le type.

ids

Identifiants pour les révisions à supprimer.

Ce paramètre est obligatoire.
Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
hide

Quoi masquer pour chaque révision.

Valeurs (séparées par |) : content, comment, user
show

Quoi démasquer pour chaque révision

Valeurs (séparées par |) : content, comment, user
suppress

S’il faut supprimer les données aux administrateurs comme aux autres.

Une valeur : yes, no, nochange
Par défaut : nochange
reason

Motif de suppression ou d’annulation de suppression.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Masquer le contenu de la révision 12345 de la page Main Page
api.php?action=revisiondelete&target=Main%20Page&type=revision&ids=12345&hide=content&token=123ABC
Masquer toutes les données de l’entrée de journal 67890 avec le motif Violation de Biographie de Personne Vivante.
api.php?action=revisiondelete&type=logging&ids=67890&hide=content|comment|user&reason=BLP%20violation&token=123ABC

action=rollback

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Annuler la dernière modification de la page.

Si le dernier utilisateur à avoir modifié la page a fait plusieurs modifications sur une ligne, elles seront toutes annulées.

Paramètres :
title

Titre de la page à restaurer. Impossible à utiliser avec pageid.

pageid

ID de la page à restaurer. Impossible à utiliser avec title.

user

Nom de l’utilisateur dont les modifications doivent être annulées.

Ce paramètre est obligatoire.
summary

Personnaliser le résumé de la modification. S’il est vide, le résumé par défaut sera utilisé.

Par défaut : (vide)
markbot

Marquer les modifications annulées et les modifications annulées comme robot.

watchlist

Ajouter ou supprimer la page de la liste de suivi de l’utilisateur actuel sans condition, utiliser les préférences ou ne pas modifier le suivi.

Une valeur : watch, unwatch, preferences, nochange
Par défaut : preferences
token

Un jeton « rollback » récupéré par action=query&meta=tokens

Pour rester compatible, le jeton utilisé dans l’IHM web est aussi accepté.

Ce paramètre est obligatoire.
Exemples :
Annuler les dernières modifications à [Main Page par l’utilisateur Exemple.
api.php?action=rollback&title=Main%20Page&user=Example&token=123ABC
Annuler les dernières modifications de la page Main Page par l’utilisateur à l’adresse IP 192.0.2.5 avec le résumé Annulation de vandalisme, et marquer ces modifications et l’annulation comme modifications de robots.
api.php?action=rollback&title=Main%20Page&user=192.0.2.5&token=123ABC&summary=Reverting%20vandalism&markbot=1

action=rsd

(main | rsd)

Exporter un schéma RSD (Découverte Très Simple).

Exemple :
Exporter le schéma RSD
api.php?action=rsd

action=setnotificationtimestamp

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Mettre à jour l’horodatage de notification pour les pages suivies.

Cela affecte la mise en évidence des pages modifiées dans la liste de suivi et l’historique, et l’envoi de courriel quand la préférence « M’envoyer un courriel quand une page de ma liste de suivi est modifiée » est activée.

Paramètres :
entirewatchlist

Travailler sur toutes les pages suivies.

timestamp

Horodatage auquel dater la notification.

torevid

Révision pour laquelle fixer l’horodatage de notification (une page uniquement).

newerthanrevid

Révision pour fixer l’horodatage de notification plus récent (une page uniquement).

continue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

titles

Une liste des titres sur lesquels travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
pageids

Une liste des IDs de page sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
revids

Une liste des IDs de révision sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
generator

Obtenir la liste des pages sur lesquelles travailler en exécutant le module de recherche spécifié.

NOTE : les noms de paramètre du générateur doivent être préfixés avec un « g », voir les exemples.

Une valeur : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
redirects

Résoudre automatiquement les redirections dans titles, pageids et revids, et dans les pages renvoyées par generator.

converttitles

Convertir les titres dans d’autres variantes si nécessaire. Fonctionne uniquement si la langue de contenu du wiki supporte la conversion en variantes. Les langues qui supportent la conversion en variante incluent gan, iu, kk, ku, shi, sr, tg, uz, zh.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Réinitialiser l’état de notification pour toute la liste de suivi
api.php?action=setnotificationtimestamp&entirewatchlist=&token=123ABC
Réinitialiser l’état de notification pour la Page principale.
api.php?action=setnotificationtimestamp&titles=Main_page&token=123ABC
Fixer l’horodatage de notification pour Page principale afin que toutes les modifications depuis le 1 janvier 2012 soient non vues
api.php?action=setnotificationtimestamp&titles=Main_page&timestamp=2012-01-01T00:00:00Z&token=123ABC
Réinitialiser l’état de notification sur les pages dans l’espace de noms Utilisateur.
api.php?action=setnotificationtimestamp&generator=allpages&gapnamespace=2&token=123ABC

action=stashedit

  • Ce module est interne ou instable. Son fonctionnement peut être modifié sans préavis.
  • Ce module nécessite des droits de lecture.
  • Ce module n’accepte que les requêtes POST.
Paramètres :
title
(aucune description)
Ce paramètre est obligatoire.
section
(aucune description)
sectiontitle
(aucune description)
text
(aucune description)
Ce paramètre est obligatoire.
contentmodel
(aucune description)
Ce paramètre est obligatoire.
Une valeur : wikitext, javascript, json, css, text
contentformat
(aucune description)
Ce paramètre est obligatoire.
Une valeur : text/x-wiki, text/javascript, application/json, text/css, text/plain
baserevid
(aucune description)
Ce paramètre est obligatoire.
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=tag

(main | tag)
  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Add or remove change tags from individual revisions or log entries.

Paramètres :
rcid

One or more recent changes IDs from which to add or remove the tag.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
revid

One or more revision IDs from which to add or remove the tag.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
logid

One or more log entry IDs from which to add or remove the tag.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
add

Tags to add. Only manually defined tags can be added.

Valeurs (séparées par |) :
remove

Tags to remove. Only tags that are either manually defined or completely undefined can be removed.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
reason

Reason for the change.

Par défaut : (vide)
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Add the vandalism tag from revision ID 123 without specifying a reason
api.php?action=tag&revid=123&add=vandalism&token=123ABC
Remove the spam tag from log entry ID 123 with the reason Wrongly applied
api.php?action=tag&logid=123&remove=spam&reason=Wrongly+applied&token=123ABC

action=tokens

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Obtenir les jetons pour les actions modifiant les données.

Ce module est obsolète, remplacé par action=query&meta=tokens.

Paramètre :
type

Types de jeton à demander.

Valeurs (séparées par |) : block, delete, edit, email, import, move, options, patrol, protect, unblock, watch
Par défaut : edit
Exemples :
Récupérer un jeton de modification (par défaut).
api.php?action=tokens
Récupérer un jeton de courriel et un jeton de déplacement.
api.php?action=tokens&type=email|move

action=unblock

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Débloquer un utilisateur.

Paramètres :
id

ID du blocage à lever (obtenu via list=blocks). Impossible à utiliser avec user.

user

Nom d’utilisateur, adresse IP ou plage d’adresse IP à débloquer. Impossible à utiliser avec id.

reason

Motif de déblocage.

Par défaut : (vide)
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Lever le blocage d’ID #105.
api.php?action=unblock&id=105
Débloquer l’utilisateur Bob avec le motif Désolé Bob.
api.php?action=unblock&user=Bob&reason=Sorry%20Bob

action=undelete

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Restaurer les révisions d’une page supprimée.

Une liste des révisions supprimées (avec les horodatages) peut être récupérée via list=deletedrevs, et une liste d’IDs de fichier supprimé peut être récupérée via list=filearchive.

Paramètres :
title

Titre de la page à restaurer.

Ce paramètre est obligatoire.
reason

Motif de restauration.

Par défaut : (vide)
timestamps

Horodatages des révisions à restaurer. Si timestamps et fileids sont vides, toutes seront restaurées.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
fileids

IDs des révisions de fichier à restaurer. Si timestamps et fileids sont vides, toutes seront restaurées.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
watchlist

Ajouter ou supprimer la page de la liste de suivi de l’utilisateur actuel sans condition, utiliser les préférences ou ne pas modifier le suivi.

Une valeur : watch, unwatch, preferences, nochange
Par défaut : preferences
token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=upload

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Télécharger un fichier, ou obtenir l’état des téléchargements en cours.

Plusieurs méthodes sont disponibles :

  • Télécharger directement le contenu du fichier, en utilisant le paramètre file.
  • Télécharger le fichier par morceaux, en utilsiant les paramètres filesize, chunk, and offset.* Pour que le serveur MédiaWiki cherche un fichier depuis une URL, utiliser le paramètre url.
  • Terminer un téléchargement précédent qui a échoué à cause d’avertissements, en utilisant le paramètre filekey.

Noter que le POST HTTP doit être fait comme un téléchargement de fichier (par ex. en utilisant multipart/form-data) en envoyant le multipart/form-data.

Paramètres :
filename

Nom de fichier cible.

comment

Télécharger le commentaire. Utilisé aussi comme texte de la page initiale pour les nouveaux fichiers si text n’est pas spécifié.

Par défaut : (vide)
text

Texte de page initiale pour les nouveaux fichiers.

watch
Obsolète.

Suivre la page.

watchlist

Ajouter ou supprimer sans condition la page de la liste de suivi de l’utilisateur actuel, utiliser les préférences ou ne pas changer le suivi.

Une valeur : watch, preferences, nochange
Par défaut : preferences
ignorewarnings

Ignorer tous les avertissements.

file

Contenu du fichier.

Doit être envoyé comme un fichier importé utilisant multipart/form-data.
url

URL où chercher le fichier.

filekey

Clé identifiant un téléchargement précédent temporairement mis en attente.

sessionkey
Obsolète.

Comme filekey, conservé pour des raisons de compatibilité descendante.

stash

Si positionné, le serveur conservera temporairement le fichier au lieu de l’ajouter au dépôt.

filesize

Taille du fichier de tout le téléchargement.

offset

Décalage du bloc en octets.

chunk

Partie du contenu.

Doit être envoyé comme un fichier importé utilisant multipart/form-data.
async

Faire de façon asynchrone les grosses opérations sur les fichiers quand c’est possible.

asyncdownload

Faire de façon asynchrone la recherche d’une URL.

leavemessage

Si asyncdownload est utilisé, laisser un message sur la page de discussion de l’utilisateur quand c’est terminé.

statuskey

Récupérer l’état de téléchargement pour cette clé de fichier (téléchargé par URL).

checkstatus

Récupérer uniquement l’état de téléchargement pour la clé de fichier donnée.

token

Un jeton « csrf » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.

action=userrights

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Modifier l’appartenance d’un utilisateur à un groupe.

Paramètres :
user

Nom d’utilisateur.

userid

ID de l’utilisateur.

add

Ajouter l’utilisateur à ces groupes.

Valeurs (séparées par |) : bot, sysop, bureaucrat, WikiSysop
remove

Supprimer l’utilisateur de ces groupes.

Valeurs (séparées par |) : bot, sysop, bureaucrat, WikiSysop
reason

Motif pour la modification.

Par défaut : (vide)
token

Un jeton « userrights » récupéré par action=query&meta=tokens

Pour rester compatible, le jeton utilisé dans l’IHM web est aussi accepté.

Ce paramètre est obligatoire.
Exemples :
Ajouter l’utilisateur FooBot au groupe robot, et le supprimer des groupes sysop et bureaucrate.
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC
Ajouter l’utilisateur d’ID 123 au groupe robot, et le supprimer des groupes sysop et bureaucrate.
api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC

action=watch

  • Ce module nécessite des droits de lecture.
  • Ce module nécessite des droits d’écriture.
  • Ce module n’accepte que les requêtes POST.

Ajouter ou supprimer des pages de la liste de suivi de l’utilisateur actuel.

Paramètres :
title
Obsolète.

La page à (ne plus) suivre. Utiliser plutôt titles.

unwatch

Si défini, la page ne sera plus suivie plutôt que suivie.

continue

Quand plus de résultats sont disponibles, utiliser cela pour continuer.

titles

Une liste des titres sur lesquels travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
pageids

Une liste des IDs de page sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
revids

Une liste des IDs de révision sur lesquelles travailler.

Valeurs séparées par |. Le nombre maximal de valeurs est 50 (500 pour les robots).
generator

Obtenir la liste des pages sur lesquelles travailler en exécutant le module de recherche spécifié.

NOTE : les noms de paramètre du générateur doivent être préfixés avec un « g », voir les exemples.

Une valeur : allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, transcludedin, watchlist, watchlistraw
redirects

Résoudre automatiquement les redirections dans titles, pageids et revids, et dans les pages renvoyées par generator.

converttitles

Convertir les titres dans d’autres variantes si nécessaire. Fonctionne uniquement si la langue de contenu du wiki supporte la conversion en variantes. Les langues qui supportent la conversion en variante incluent gan, iu, kk, ku, shi, sr, tg, uz, zh.

token

Un jeton « watch » récupéré par action=query&meta=tokens

Ce paramètre est obligatoire.
Exemples :
Suivre la page Page principale.
api.php?action=watch&titles=Main_Page&token=123ABC
Ne plus suivre la page Page principale.
api.php?action=watch&titles=Main_Page&unwatch=&token=123ABC
Suivre les quelques premières pages de l’espace de nom principal
api.php?action=watch&generator=allpages&gapnamespace=0&token=123ABC

format=dbg

(main | dbg)
  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format de var_export() de PHP.

Exemple :
Mettre en forme le résultat de la requête dans le format DBG
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dbg

format=dbgfm

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format de var_export() de PHP (affiché proprement en HTML).

Exemple :
Mettre en forme le résultat de la requête dans le format DBG
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dbgfm

format=dump

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format de var_dump() de PHP.

Exemple :
Mettre en forme le résultat de la requête dans le format DUMP
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dump

format=dumpfm

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format de var_dump() de PHP (affiché proprement en HTML).

Exemple :
Mettre en forme le résultat de la requête dans le format DUMP
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dumpfm

format=json

  • Ce module nécessite des droits de lecture.

Extraire les données au format JSON.

Paramètres :
callback

Si spécifié, inclut la sortie dans l’appel d’une fonction fournie. Pour plus de sûreté, toutes les données spécifiques à l’utilisateur seront restreintes.

utf8

Si spécifié, encode la plupart (mais pas tous) des caractères non ASCII en URF-8 au lieu de les remplacer par leur séquence d’échappement hexadécimale.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
Une valeur : 1, 2, latest
Par défaut : 1
Exemple :
Mettre en forme le résultat de la requête dans le format JSON
api.php?action=query&meta=siteinfo&siprop=namespaces&format=json

format=jsonfm

  • Ce module nécessite des droits de lecture.

Extraire les données au format JSON (affiché proprement en HTML).

Paramètres :
callback

Si spécifié, inclut la sortie dans l’appel d’une fonction fournie. Pour plus de sûreté, toutes les données spécifiques à l’utilisateur seront restreintes.

utf8

Si spécifié, encode la plupart (mais pas tous) des caractères non ASCII en URF-8 au lieu de les remplacer par leur séquence d’échappement hexadécimale.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
Une valeur : 1, 2, latest
Par défaut : 1
Exemple :
Mettre en forme le résultat de la requête dans le format JSON
api.php?action=query&meta=siteinfo&siprop=namespaces&format=jsonfm

format=none

  • Ce module nécessite des droits de lecture.

Ne rien extraire.

Exemple :
Mettre en forme le résultat de la requête dans le format NONE
api.php?action=query&meta=siteinfo&siprop=namespaces&format=none

format=php

(main | php)
  • Ce module nécessite des droits de lecture.

Extraire les données au format sérialisé de PHP.

Paramètre :
formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
Une valeur : 1, 2, latest
Par défaut : 1
Exemple :
Mettre en forme le résultat de la requête dans le format PHP
api.php?action=query&meta=siteinfo&siprop=namespaces&format=php

format=phpfm

  • Ce module nécessite des droits de lecture.

Extraire les données au format sérialisé de PHP (affiché proprement en HTML).

Paramètre :
formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
Une valeur : 1, 2, latest
Par défaut : 1
Exemple :
Mettre en forme le résultat de la requête dans le format PHP
api.php?action=query&meta=siteinfo&siprop=namespaces&format=phpfm

format=rawfm

  • Ce module nécessite des droits de lecture.

Extraire les données avec les éléments de débogage au format JSON (affiché proprement en HTML).

Exemple :
Mettre en forme le résultat de la requête dans le format RAW
api.php?action=query&meta=siteinfo&siprop=namespaces&format=rawfm

format=txt

(main | txt)
  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format de print_r() de PHP.

Exemple :
Mettre en forme le résultat de la requête dans le format TXT
api.php?action=query&meta=siteinfo&siprop=namespaces&format=txt

format=txtfm

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format de print_r() de PHP (affiché proprement en HTML).

Exemple :
Mettre en forme le résultat de la requête dans le format TXT
api.php?action=query&meta=siteinfo&siprop=namespaces&format=txtfm

format=wddx

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format WDDX.

Exemple :
Mettre en forme le résultat de la requête dans le format WDDX
api.php?action=query&meta=siteinfo&siprop=namespaces&format=wddx

format=wddxfm

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format WDDX (affiché proprement en HTML).

Exemple :
Mettre en forme le résultat de la requête dans le format WDDX
api.php?action=query&meta=siteinfo&siprop=namespaces&format=wddxfm

format=xml

(main | xml)
  • Ce module nécessite des droits de lecture.

Extraire les données au format XML.

Paramètres :
xslt

Si spécifié, ajoute la page nommée comme une feuille de style XSL. La valeur doit être un titre dans l’espace de noms MediaWiki se terminant par .xsl.

includexmlnamespace

Si spécifié, ajoute un espace de noms XML.

Exemple :
Mettre en forme le résultat de la requête dans le format XML
api.php?action=query&meta=siteinfo&siprop=namespaces&format=xml

format=xmlfm

  • Ce module nécessite des droits de lecture.

Extraire les données au format XML (affiché proprement en HTML).

Paramètres :
xslt

Si spécifié, ajoute la page nommée comme une feuille de style XSL. La valeur doit être un titre dans l’espace de noms MediaWiki se terminant par .xsl.

includexmlnamespace

Si spécifié, ajoute un espace de noms XML.

Exemple :
Mettre en forme le résultat de la requête dans le format XML
api.php?action=query&meta=siteinfo&siprop=namespaces&format=xmlfm

format=yaml

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données au format YAML.

Paramètres :
callback

Si spécifié, inclut la sortie dans l’appel d’une fonction fournie. Pour plus de sûreté, toutes les données spécifiques à l’utilisateur seront restreintes.

utf8

Si spécifié, encode la plupart (mais pas tous) des caractères non ASCII en URF-8 au lieu de les remplacer par leur séquence d’échappement hexadécimale.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
Une valeur : 1, 2, latest
Par défaut : 1
Exemple :
Mettre en forme le résultat de la requête dans le format YAML
api.php?action=query&meta=siteinfo&siprop=namespaces&format=yaml

format=yamlfm

  • Ce module est obsolète.
  • Ce module nécessite des droits de lecture.

Extraire les données YAML (affiché proprement en HTML).

Paramètres :
callback

Si spécifié, inclut la sortie dans l’appel d’une fonction fournie. Pour plus de sûreté, toutes les données spécifiques à l’utilisateur seront restreintes.

utf8

Si spécifié, encode la plupart (mais pas tous) des caractères non ASCII en URF-8 au lieu de les remplacer par leur séquence d’échappement hexadécimale.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
Une valeur : 1, 2, latest
Par défaut : 1
Exemple :
Mettre en forme le résultat de la requête dans le format YAML
api.php?action=query&meta=siteinfo&siprop=namespaces&format=yamlfm

Remerciements

Développeurs de l’API :

  • Roan Kattouw (développeur en chef Sept. 2007–2009)
  • Victor Vasiliev
  • Bryan Tong Minh
  • Sam Reed
  • Yuri Astrakhan (créateur, développeur en chef Sept. 2006–Sept. 2007)
  • Brad Jorsch (développeur en chef depuis 2013)

Veuillez envoyer vos commentaires, suggestions et questions à mediawiki-api@lists.wikimedia.org ou remplir un rapport de bogue sur https://phabricator.wikimedia.org/.