Aide de l’API MediaWiki
Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.
Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
Module principal
- Source : MediaWiki
- Licence : GPL-2.0-or-later
État : l’API de MediaWiki est une interface stable et mature qui est prise en charge et améliorée de façon active. Bien que nous essayions de l’éviter, nous avons parfois besoin de faire des modifications non rétrocompatibles ; 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 entête HTTP sera renvoyé avec la clé « MediaWiki-API-Error ». La valeur de cet entête et le code d’erreur renvoyé prendront la même valeur. Pour plus d’informations, voyez API:Erreurs et avertissements.
Test : pour faciliter le test des requêtes à l’API, utilisez le bac à sable de l’API.
- action
Quelle action effectuer.
- block
- Bloquer un utilisateur.
- bs-adminuser-store
- Liste tous les utilisateurs de la base de données avec des données sensibles supplémentaires. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres de ExtJS Store.
- bs-avatars-tasks
- Téléversement, génération et initialisation des avatars utilisateur
- bs-category-store
- Liste toutes les catégories. Permet le tri, le filtrage et la mise en forme. Met en œuvre les paramètres de ExtJS Store.
- bs-category-treestore
- Affiche les sous-catégories d’une catégorie spécifique
- bs-categorylinks-store
- Répertorie toutes les catégories d’une page, y compris un lien vers la page de catégorie et un marqueur pour les catégories explicites et implicites.
- bs-checklist-available-options-store
- Liste toutes les options disponibles pour les modèles de liste de vérification. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres ExtJS Store.
- bs-checklist-tasks
- Fournit les opérations pour l’extension « Liste de vérification »
- bs-checklist-template-store
- Liste tous les modèles qui sont des sources de liste de vérification valides. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres ExtJS Store.
- bs-configmanager-store
- Gérer les magasins
- bs-configmanager-tasks
- Gérer les tâches
- bs-contextmenu-tasks
- Fournit les éléments de menu de contexte présents dans le contexte
- bs-dashboards-store
- Liste de toutes les portlets disponibles
- bs-dashboards-tasks
- Enregistre la configuration du tableau de bord
- bs-dashboards-widgets-tasks
- Renvoie le contenu de certains widgets de tableau de bord
- bs-filebackend-store
- Liste tous les fichiers du serveur de fichiers. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres de ExtJS Store.
- bs-group-store
- Liste tous les groupes sauf $wgImplicitGroups. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres de ExtJS Store.
- bs-groupmanager
- Fournit les tâches de l’extension GroupManager.
- bs-insertfile-license-store
- Affiche les licences de l’extension InsertFile.
- bs-interwiki-store
- Affiche tous les liens interwiki. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres de ExtJS Store.
- bs-interwikilinks-tasks
- Fournit les tâches pour l’extension InterWikiLinks.
- bs-js-var-config
- Fournit un point d’accès à l’API pour récupérer des variables de configuration côté client
- bs-linker
- Renvoie les liens vers les pages générées par Linker
- bs-mypageassignment-store
- Renvoie les pages affectées à l’utilisateur actuel
- bs-namespace-store
- Liste tous les espaces de nom et la configuration arbitraire. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres pour ExtJS Store.
- bs-namespace-tasks
- Autorise la modification de la configuration des espaces de noms.
- bs-pageaccess-store
- Contrôler l’accès sur le niveau de page
- bs-pageassignable-store
- Retourne la liste des assignés
- bs-pageassignment-store
- Renvoie les assignations de la page donnée
- bs-pageassignment-tasks
- Obtenir ou modifier la liste des assignations pour une page spécifique
- bs-pageauthors-store
- Lister tous les auteurs d’une page fournie dans le contexte
- bs-pagetemplate-tags-store
- Liste toutes les balises de modèle de page. Permet de trier, filtrer et paginer. Met en œuvre les paramètres pour ExtJS Store.
- bs-pagetemplates-store
- Liste tous les modèles de page. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres pour ExtJS Store.
- bs-pagetemplates-tasks
- Permet la manipulation des modèles de page
- bs-permissionmanager-tasks
- Fournit des tâches pour le Gestionnaire d’autorisations
- bs-ping-tasks
- Tâche de ping qui réalise un échange continu de données
- bs-qr-code
- Obtenir le code QR pour une page sous forme d’URI de données codées en base64.
- bs-readers-data-store
- Fournit les informations concernant les lecteurs d’une page spécifique.
- bs-readers-page-readers-store
- Obtient toutes les informations concernant les lecteurs de toutes les pages
- bs-readers-revision-readers-store
- Obtient toutes les informations concernant les lecteurs de toutes les versions d’une page
- bs-readers-tasks
- Fournit les opérations courantes pour les lecteurs
- bs-readers-users-store
- Obtenir toutes les informations concernant les lecteurs d’une page spécifique.
- bs-recentchanges-store
- Affiche l’ensemble des modifications récentes. Permet de trier, de filtrer et de mettre en forme. Met en œuvre les paramètres de stockage.
- bs-role-permission-store
- Fournir une description du rôle pour le Gestionnaire d’autorisations
- bs-rss-standards-pages-store
- Retourne la liste des pages disponibles pour RSSFeeder
- bs-rssfeeder-tasks
- Fournit les tâches communes pour l’Alimenteur de flux RSS
- bs-smartlist-tasks
- Fonctions API pour servir les données de portlet pour la page et les statistiques utilisateur.
- bs-statistics-available-diagrams-store
- Fournit un magasin avec les diagrammes disponibles
- bs-statistics-search-options-store
- Fournit un stockage avec des options de recherche disponibles
- bs-statistics-tasks
- Fournit les tâches communes dédiées aux statistiques
- bs-task
- Fournit le point de terminaison de l’API pour l’exécution de tâches enregistrées
- bs-templatelinks-store
- Répertorie tous les modèles d’une page, y compris un lien vers le modèle.
- bs-titlequery-store
- Liste les titres de page et (facultativement) les préfixes d’espaces de nom basés sur un terme de recherche. Met en œuvre les paramètres de ExtJS Store.
- bs-upload-license-store
- Afficher toutes les licences disponibles pour le téléversement d’un fichier
- bs-usagetracker-store
- Détient des données statistiques concernant l’utilisation de l’extension
- bs-user-store
- Liste tous les utilisateurs de la base de données. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres de ExtJS Store.
- bs-usermanager-group-store
- Fournit l’API des tâches de gestion des utilisateur pour BlueSpice.
- bs-usermanager-tasks
- Fournit les opérations pour l’extension Checklist
- bs-watchlist-store
- Liste toutes les entrées des listes de suivi. Permet le tri, le filtrage et la mise en forme. Met en œuvre les paramètres de stockage.
- bs-wikipage-store
- Liste toutes les pages du wiki. Permet le tri, le filtrage et la pagination. Met en œuvre les paramètres de ExtJS Store.
- bs-wikipage-tasks
- Fournit les opérations communes sur les pages wiki
- bs-wikisubpage-treestore
- Affiche les sous-pages d’une page wiki spécifique
- changeauthenticationdata
- Modifier les données d’authentification pour l’utilisateur actuel.
- changecontentmodel
- Modifier le modèle de contenu d’une page
- checktoken
- Vérifier la validité d’un jeton de action=query&meta=tokens.
- clearhasmsg
- Efface le drapeau
hasmsg
pour l’utilisateur actuel. - clientlogin
- Se connecter au wiki en utilisant la procédure interactive.
- compare
- Obtenir la différence entre deux pages.
- createaccount
- Créer un nouveau compte d’utilisateur.
- delete
- Supprimer une page.
- deletecomment
- edit
- Créer et modifier des pages.
- emailuser
- Envoyer un courriel à un utilisateur.
- embedvideo
- Obtenez le code d’intégration de la vidéo généré pour les paramètres donnés.
- expandtemplates
- Réalise l’expansion de tous les modèles en wikicode.
- feedcontributions
- Renvoie le fil des contributions d’un utilisateur.
- feedrecentchanges
- Renvoie un fil de modifications récentes.
- feedwatchlist
- Renvoie un flux de liste de suivi.
- filerevert
- Rétablir un fichier dans une ancienne version.
- flexiskin-activation
- Le module d’activation
- flexiskin-delete
- Le module de suppression
- flexiskin-preview
- Le module d’aperçu
- flexiskin-save
- Le module de sauvegarde
- getallcomments
- help
- Afficher l’aide pour les modules spécifiés.
- imagerotate
- Faire pivoter une ou plusieurs images.
- import
- Importer une page depuis un autre wiki ou depuis un fichier XML.
- linkaccount
- Lier un compte d’un fournisseur tiers à l’utilisateur actuel.
- loadcomments
- login
- Se connecter et récupérer les témoins (cookies) d’authentification.
- logout
- Se déconnecter et effacer les données de session.
- managetags
- Effectuer des tâches de gestion relatives aux balises de modification.
- mergehistory
- Fusionner les historiques des pages.
- move
- Déplacer une page.
- opensearch
- Rechercher dans le wiki en utilisant le protocole OpenSearch.
- options
- Modifier les préférences de l'utilisateur actuel.
- paraminfo
- Obtenir des informations sur les modules de l’API.
- parse
- Analyse le contenu et renvoie le résultat de l’analyseur.
- patrol
- Patrouiller une page ou une version.
- postcomment
- postreply
- protect
- Modifier le niveau de protection d’une page.
- purge
- Vider le cache des titres fournis.
- query
- Récupérer des données de MediaWiki et à propos de celui-ci.
- removeauthenticationdata
- Supprimer les données d’authentification pour l’utilisateur actuel.
- resetpassword
- Envoyer un courriel de réinitialisation du mot de passe à un utilisateur.
- revisiondelete
- Supprimer et rétablir des révisions.
- rollback
- Annuler les dernières modifications de la page.
- rsd
- Exporter un schéma RSD (Découverte Très Simple).
- setnotificationtimestamp
- Mettre à jour l’horodatage de notification pour les pages suivies.
- setpagelanguage
- Modifier la langue d’une page.
- tag
- Ajouter ou retirer des balises de modification aux révisions ou aux entrées de journal individuelles.
- unblock
- Débloquer un utilisateur.
- undelete
- Restaurer des versions d’une page supprimée.
- unlinkaccount
- Supprimer un compte tiers lié de l’utilisateur actuel.
- upload
- Téléverser un fichier, ou obtenir l’état des téléversements en cours.
- userrights
- Modifier l’appartenance d’un utilisateur à un groupe.
- validatepassword
- Valider un mot de passe conformément aux règles concernant les mots de passe du wiki.
- watch
- Ajouter ou supprimer des pages de la liste de suivi de l’utilisateur actuel.
- categorytree
- Interne. Module interne pour l’extension CategoryTree.
- cspreport
- Interne. Utilisé par les navigateurs pour signaler les violations de la politique de confidentialité du contenu. Ce module ne devrait jamais être utilisé, sauf quand il est utilisé automatiquement par un navigateur web compatible avec CSP.
- stashedit
- Interne. Préparer des modifications dans le cache partagé.
- visualeditor
- Interne. Renvoie une page HTML5 du service Parsoid.
- visualeditoredit
- Interne. Enregistrer une page HTML5 en MediaWiki (convertie en wikicode via le service Parsoid).
- Une des valeurs suivantes : block, bs-adminuser-store, bs-avatars-tasks, bs-category-store, bs-category-treestore, bs-categorylinks-store, bs-checklist-available-options-store, bs-checklist-tasks, bs-checklist-template-store, bs-configmanager-store, bs-configmanager-tasks, bs-contextmenu-tasks, bs-dashboards-store, bs-dashboards-tasks, bs-dashboards-widgets-tasks, bs-filebackend-store, bs-group-store, bs-groupmanager, bs-insertfile-license-store, bs-interwiki-store, bs-interwikilinks-tasks, bs-js-var-config, bs-linker, bs-mypageassignment-store, bs-namespace-store, bs-namespace-tasks, bs-pageaccess-store, bs-pageassignable-store, bs-pageassignment-store, bs-pageassignment-tasks, bs-pageauthors-store, bs-pagetemplate-tags-store, bs-pagetemplates-store, bs-pagetemplates-tasks, bs-permissionmanager-tasks, bs-ping-tasks, bs-qr-code, bs-readers-data-store, bs-readers-page-readers-store, bs-readers-revision-readers-store, bs-readers-tasks, bs-readers-users-store, bs-recentchanges-store, bs-role-permission-store, bs-rss-standards-pages-store, bs-rssfeeder-tasks, bs-smartlist-tasks, bs-statistics-available-diagrams-store, bs-statistics-search-options-store, bs-statistics-tasks, bs-task, bs-templatelinks-store, bs-titlequery-store, bs-upload-license-store, bs-usagetracker-store, bs-user-store, bs-usermanager-group-store, bs-usermanager-tasks, bs-watchlist-store, bs-wikipage-store, bs-wikipage-tasks, bs-wikisubpage-treestore, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, deletecomment, edit, emailuser, embedvideo, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, flexiskin-activation, flexiskin-delete, flexiskin-preview, flexiskin-save, getallcomments, help, imagerotate, import, linkaccount, loadcomments, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, postcomment, postreply, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, tag, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, categorytree, cspreport, stashedit, visualeditor, visualeditoredit
- Par défaut : help
- format
Le format de sortie.
- json
- Sortir les données au format JSON.
- jsonfm
- Extraire les données au format JSON (HTML mis en forme améliorée pour l’impression).
- none
- Ne rien extraire.
- php
- Extraire les données au format sérialisé de PHP.
- phpfm
- Extraire les données au format sérialisé de PHP (mise en forme HTML améliorée pour l'impression).
- rawfm
- Extraire les données, y compris les éléments de débogage, au format JSON (mise en forme HTML améliorée pour l'impression).
- xml
- Extraire les données au format XML.
- xmlfm
- Extraire les données au format XML (affiché proprement en HTML).
- Une des valeurs suivantes : json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- Par défaut : jsonfm
- maxlag
La latence maximale peut être utilisée quand MediaWiki est installé sur une grappe de réplication de bases de données. 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 : paramètre Maxlag pour plus d’informations.- Type: entier
- smaxage
Fixer l’entête HTTP de contrôle de cache
s-maxage
à ce nombre de secondes. Les erreurs ne sont jamais mises en cache.- Type: entier
- Par défaut : 0
- maxage
Fixer l’entête HTTP de contrôle de cache
max-age
au nombre indiqué de secondes. Les erreurs ne sont jamais mises en cache.- Type: entier
- Par défaut : 0
- assert
Vérifier que l’utilisateur est connecté lorsque la valeur est user, ou bien qu’il n’est pas connecté si elle est anon, ou encore qu’il a le droit d’un utilisateur robot lorsque la valeur est bot.
- Une des valeurs suivantes : anon, bot, user
- assertuser
Vérifier que l’utilisateur actuel est l’utilisateur nommé.
- Type : utilisateur, par nom d’utilisateur
- 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.
- Type : booléen (détails)
- curtimestamp
Inclure l’horodatage actuel dans le résultat.
- Type : booléen (détails)
- responselanginfo
Inclure les langues utilisées pour uselang et errorlang dans le résultat.
- Type : booléen (détails)
- origin
En accédant à l’API au moyen d’une requête AJAX inter-domaines (CORS), indiquez le protocole et le nom de domaine d’origine dans ce paramètre. Celui-ci doit être inclus dans toute requête de pré-envol et doit donc faire partie de l’URI de la requête (pas du corps de la requête POST).
Pour les requêtes authentifiées, cela doit correspondre exactement à une des origines dans l’entête
Origin
, il doit donc être fixé avec quelque chose comme https://en.wikipedia.org ou https://meta.wikimedia.org. Si ce paramètre ne correspond pas à l’entêteOrigin
, une réponse 403 sera renvoyée. Si ce paramètre correspond à l’entêteOrigin
et l’origine indiquée est autorisée, l’API renseignera les entêtesAccess-Control-Allow-Origin
etAccess-Control-Allow-Credentials
dans sa réponse.Pour les requêtes non authentifiées, indiquez la valeur *. L’API renseignera l’entête
Access-Control-Allow-Origin
dans sa réponse, maisAccess-Control-Allow-Credentials
vaudrafalse
et toutes les données spécifiques à l’utilisateur seront restreintes.- uselang
Langue à utiliser pour les traductions de message : utilisez la requête de l’API action=query&meta=siteinfo avec siprop=languages pour renvoyer une liste de codes de langue, sinon indiquez user pour utiliser la langue préférée de l’utilisateur actuel, ou bien content pour utiliser la langue du contenu de ce wiki.
- Par défaut : user
- variant
Variante de la langue. Ne fonctionne que si la langue de base prend en charge la conversion en variante.
- errorformat
Format à utiliser pour la sortie de texte d’avertissement et d’erreur
- plaintext
- Wikicode avec les balises HTML supprimés et les entités remplacées.
- wikitext
- Wikicode non analysé.
- html
- HTML
- raw
- Clé et paramètres du message.
- none
- Sortie sans texte, seulement les codes d’erreur.
- bc
- Format utilisé avant MediaWiki 1.29. errorlang et errorsuselocal sont ignorés.
- Une des valeurs suivantes : bc, html, none, plaintext, raw, wikitext
- Par défaut : bc
- errorlang
Langue à utiliser pour les avertissements et les erreurs. Spécifier un des codes langues utilisables renvoyés par action=query&meta=siteinfo avec siprop=languages, sinon content pour utiliser la langue du contenu de ce wiki, ou encore uselang pour utiliser la même valeur que le paramètre uselang (la langue préférée pour l’interface utilisateur).
- Par défaut : uselang
- errorsuselocal
S’il est fourni, les textes d’erreur utiliseront des messages adaptés à la langue dans l’espace de noms MediaWiki.
- Type : booléen (détails)
- Aide pour le module principal.
- api.php?action=help [ouvrir dans le bac à sable]
- Toute l’aide sur une page.
- api.php?action=help&recursivesubmodules=1 [ouvrir dans le bac à sable]
Type de données
Toute entrée de texte dans MediaWiki devrait être encodée en UTF-8 sous forme normalisée canonique précomposée (NFC). MediaWiki peut tenter de convertir d’autres entrées, mais cela peut faire échouer certaines opérations (comme des modifications de pages avec les vérifications MD5).
Les paramètres qui prennent plusieurs valeurs sont normalement soumis avec les valeurs séparées par des barres verticales, par ex. param=valeur1|valeur2 ou param=valeur1%7Cvaleur2. Si une valeur doit contenir une barre verticale, utiliser le contrôle U+001F (séparateur d’unité) comme séparateur et préfixer la valeur par U+001F, par ex. param=%1Fvaleur1%1Fvaleur2.
Certains types de paramètre dans les requêtes de l’API nécessitent plus d’explications :
- boolean
Les paramètres booléens fonctionnent comme des cases à cocher HTML : si le paramètre est spécifié, quelle que soit sa valeur, il est considéré comme vrai. Pour une valeur fausse, omettre complètement le paramètre.
- expiry
Les valeurs d’expiration peuvent être relatives (par ex. 5 months pour 5 mois ou 2 weeks pour 2 semaines) ou absolues (par ex. 2014-09-18T12:34:56Z). Pour ne pas avoir d’expiration, utiliser infinite (infini), indefinite (non défini), infinity (infinité) ou never (jamais).
- timestamp
Les horodatages peuvent être spécifiés sous plusieurs formes, voir les formats d’entrée de la bibliothèque Timestamp documentés sur mediawiki.org pour plus de détails. La date et l’heure ISO 8601 sont recommandés : 2001-01-15T14:56:00Z. De plus, la chaîne now peut être utilisée pour spécifier l’horodatage courant.
Paramètres de modèle
Les paramètres dynamiques (nommés selon un format modèle) prennent en charge les cas où un module d’API a besoin d’une valeur pour chaque valeur d’un autre paramètre quelconque. Par exemple, s’il y avait un module d’API pour demander un fruit, il pourrait avoir un paramètre statique fruits pour spécifier quels fruits sont demandés et un paramètre dynamique {fruit}-quantité pour spécifier la quantité demandée de chacun des fruits. Un client de l’API qui voudrait une pomme, cinq bananes et vingt fraises pourrait alors faire une requête comme fruits=pommes|bananes|fraises&pommes-quantité=1&bananes-quantité=5&fraises-quantité=20.
Remerciements
Développeurs de l’API :
- Yuri Astrakhan (créateur, développeur en chef de sept. 2006 à sept. 2007)
- Roan Kattouw (développeur en chef de sept. 2007 à 2009)
- Victor Vasiliev
- Bryan Tong Minh
- Sam Reed
- Brad Jorsch (développeur en chef de 2013 à 2020)
Veuillez envoyer vos commentaires, suggestions et questions à mediawiki-api@lists.wikimedia.org ou remplir un rapport de bogue sur https://phabricator.wikimedia.org/.