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
Information générales
É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.
Request methods
Action API requests may use GET and POST methods. Prefer using the GET method, which allows requests to be routed to faster replica servers and responses to be cached, unless the length of the URL with parameters would exceed its length limit (commonly 8000 bytes), or a module only accepts POST requests.
Parameters for POST requests may be sent in the query part of the request URL (like in GET requests) and in the POST request body, and mixing both ways in one request is allowed. Certain parameters such as passwords must be sent in the request body. If the same parameter is sent as part of the URL and also in the request body, it must have the same value in both places.
Tipe de donadas
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. la chaîne now peut être utilisée pour spécifier l’horodatage courant.
Limites
Most API modules can accept up to 50 inputs in multivalue parameters, and can return up to 500 results per query (50 results for slow queries).
For users with the apihighlimits right (Bòts e Administrators), the limits are increased to 500 inputs and 5 000 results (500 results for slow queries).
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.
Modul principal
- Font : MediaWiki
- Licéncia : GPL-2.0-or-later
Specify the action to perform, the format of the response, and options that apply to all API modules.
- action
Quina accion cal efectuar.
- abusefiltercheckmatch
- Vérifier pour voir si un AbuseFilter correspond à un ensemble de variables, à une modification ou à un événement AbuseFilter du journal.
- abusefilterchecksyntax
- Vérifier la syntaxe d’un filtre anti-abus.
- abusefilterevalexpression
- Évalue une expression de filtre anti-abus.
- abusefilterunblockautopromote
- Annule le blocage par un filtre anti-abus des promotions automatiques de statut d’un utilisateur.
- abuselogprivatedetails
- Afficher les détails privés d’une entrée de AbuseLog.
- acquiretempusername
- Obtenir un nom d’utilisateur temporaire et le stocker dans la session en cours, si la création de comptes temporaires est activée et si l’utilisateur actuel est déconnecté. Si un nom a déjà été stocké, renvoie ce même nom.
- antispoof
- Contrôler un nom d’utilisateur d’après les règles de normalisation d’AntiSpoof.
- block
- Blocar un utilizaire.
- centralauthtoken
- Récupérer un jeton central d’authentification pour faire une requête authentifiée vers un wiki attaché.
- centralnoticecdncacheupdatebanner
- Demander la purge du contenu du bandeau stocké dans le cache CDN (côté utilisateur) pour les utilisateurs anonymes, pour le bandeau et la langue spécifiés
- centralnoticechoicedata
- Obtenir les données nécessaires pour choisir un bandeau pour un projet et une langue donnés
- centralnoticequerycampaign
- Obtenir tous les paramètres de configuration d’une campagne.
- 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
hasmsgpour l’utilisateur actuel. - clientlogin
- Se connecter au wiki en utilisant la procédure interactive.
- communityconfigurationedit
- Change the content of a configuration provider in Community configuration
- compare
- Obtenir la différence entre deux pages.
- createaccount
- Creatz un novèl compte d'utilizaire.
- createlocalaccount
- Créez de force un compte local. Le compte central doit exister.
- cxdelete
- Supprimer un brouillon de traduction créé en utilisant l’extension de Traduction de contenu.
- cxtoken
- Obtenir des jetons JWT pour l’authentifications avec cxserver.
- delete
- Suprimir una pagina.
- deleteglobalaccount
- Supprimer un utilisateur global.
- discussiontoolsedit
- Publica un missatge en una pàgina de discussió.
- discussiontoolsfindcomment
- Trouver un commentaire par son identifiant ou son nom.
- discussiontoolsgetsubscriptions
- Obtenir les états d’inscription des sujets donnés.
- discussiontoolssubscribe
- Afegiu-vos (o elimineu-vos) d'una llista de seguiment per seguir o no les notificacions d'un tema.
- discussiontoolsthank
- Envoyer publiquement une notification de remerciement pour un commentaire.
- echocreateevent
- Déclencher manuellement l'envoi de notification à un utilisateur
- echomarkread
- Marquer les notifications comme lues pour l’utilisateur actuel.
- echomarkseen
- Marquer les notifications comme vues pour l’utilisateur courant.
- echomute
- Faire taire ou non les notifications issues de certains utilisateurs ou pages.
- edit
- Crear e modificar las paginas.
- editmassmessagelist
- Modifier une liste de diffusion de messages en masse.
- emailuser
- Mandar un corrièr electronic un l’utilizator.
- expandtemplates
- Réalise l’expansion de tous les modèles en wikicode.
- featuredfeed
- Renvoie un flux du contenu mis en vedette.
- feedcontributions
- Renvia lo fial de las contribucions d’un utilizaire.
- feedrecentchanges
- Renvoie un fil de modifications récentes.
- feedwatchlist
- Renvia un flux de lista de seguiment.
- filerevert
- Rétablir un fichier dans une ancienne version.
- globalblock
- Bloquer ou débloquer globalement un utilisateur.
- globalpreferenceoverrides
- Réinitialiser les remplacements locaux avec les préférences globales pour l’utilisateur actuel.
- globalpreferences
- Modifier les préférences globales de l’utilisateur actuel.
- globaluserrights
- Ajouter / retirer un utilisateur de / à des groupes globaux.
- growthmanagementorlist
- Gérer les informations dans la liste structurée des tuteurs (habituellement enregistrée dans MediaWiki:GrowthMentors.json). Ce module peut être utilisé à la fois par les tuteurs actuels et futurs (pour qu’ils s’y inscrivent eux-mêmes ou modifient leurs détails) et par les administrateurs (pour gérer les inscriptions de tous les utilisateurs).
- growthmentordashboardupdatedata
- Programmer une mise à jour extraordinaire du module de supervision des tutorés dans le tableau de bord du tuteur. Vous ne pouvez programmer qu’une seule mise à jour toutes les deux heures, pour des raisons de performance.
- growthsetmenteestatus
- Définir l’état de l'apprenti (permet aux apprentis d’activer / désactiver le module de mentorat, ou de se désinscrire complètement, ce qui supprime la relation apprenti – tuteur).
- growthsetmentor
- Définir le tuteur de l’utilisateur. La modification sera journalisée publiquement.
- growthstarmentee
- Marquer ou supprimer le marquage d’un tutoré tel que signalé d’une étoile par l’utilisateur courant (stocké de façon confidentielle et non journalisé)
- help
- Mostra l’ajuda dels mòduls especificats.
- homepagequestionstore
- Obtenir des questions formatées publiées via les modules de la page d’accueil
- imagerotate
- Aqueste modul es estat desactivat.
- import
- Importer une page depuis un autre wiki ou depuis un fichier XML.
- jsonconfig
- Permet l’accès direct au sous-système JsonConfig.
- languagesearch
- Rechercher des noms de langage dans n’importe quel script.
- linkaccount
- Lier un compte d’un fournisseur tiers à l’utilisateur actuel.
- 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
- Efectuar de prètzfaits de gestion relatius a la modificacion de las balisas.
- massmessage
- Envoyer un message à une liste de pages.
- mergehistory
- Fusionar leis istorics de pagina
- move
- Desplaçar una pagina.
- 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
- Patrolhar una pagina o una revision.
- protect
- Modificar lo nivèl de proteccion d’una pagina.
- 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
- Mandar un corrier electronic de reïnicializacion de son senhau a l'utilizaire.
- 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).
- setglobalaccountstatus
- Masque ou verrouille (ou affiche ou déverrouille) un compte utilisateur global.
- setnotificationtimestamp
- Mettre à jour l’horodatage de notification pour les pages suivies.
- setpagelanguage
- Modifier la langue d’une page.
- shortenurl
- Raccourcir une longue URL en une autre plus courte.
- sitematrix
- Obtenir la liste des sites de Wikimedia.
- spamblacklist
- Valider une ou plusieurs URL selon la liste de blocage du pollupostage.
- streamconfigs
- Expose la configuration du flux d’événements. Renvoie uniquement « format=json » avec « formatversion=2 ».
- strikevote
- Permet aux administrateurs d’annuler ou de réintégrer un vote.
- sxdelete
- Supprimer la traduction de section ébauchée et ses corpus parallèles de la base de données.
- tag
- Ajouter ou retirer des balises de modification aux révisions ou aux entrées de journal individuelles.
- templatedata
- Récupérer les données stockées par l’extension TemplateData.
- thank
- Envia una notificació d'agraïment a un editor.
- titleblacklist
- Valider un titre de page, un nom de fichier ou un nom d’utilisateur d’après la liste des titres interdits.
- torblock
- Vérifier si une adresse IP est bloquée en tant que nœud de sortie de Tor.
- transcodereset
- Les utilisateurs avec le droit 'transcode-reset' peuvent réinitialiser et relancer une tâche de transcodage.
- unblock
- Desblocar un utilizaire.
- 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.
- webapp-manifest
- Retourne un manifeste de « webapp ».
- webauthn
- Module API pour communiquer entre serveur et client pendant le processus d’inscription/authentification.
- bouncehandler
- Interne. Recevoir un courriel de rebond et le traiter pour gérer le destinataire erroné.
- categorytree
- Interne. Mòdul intern per a l'extensió CategoryTree.
- chartinfo
- Interne. Récupérer le nombre actuel d'utilisations uniques d'une page de graphique. Plusieurs utilisations d'un même graphique sur la même page sont considérées comme une seule utilisation.
- cirrus-check-sanity
- Interne. Rapporte l'exactitude d'une plage d'identifiants de page dans l'index de recherche
- cirrus-config-dump
- Interne. Dump de la configuration de CirrusSearch.
- cirrus-profiles-dump
- Interne. Vidage des profils CirrusSearch de ce wiki.
- cirrus-schema-dump
- Interne. Dump of CirrusSearch schema (settings and mappings) for this wiki.
- codemirror-validate
- Interne. Contrôler la présence d'erreurs de validation dans le contenu fourni.
- collection
- Interne. Module d’API pour effectuer diverses opérations sur la collection de l’utilisateur du wiki.
- 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.
- cxcheckunreviewed
- Interne. Vérifiez si une traduction rapide et non révisée a été publiée récemment pour l'utilisateur actuel.
- cxfavoritesuggestions
- Interne. Ajoutez ou supprimez une suggestion favorite à la liste de l'utilisateur actuel.
- cxpublish
- Interne. Enregistrer une page créée en utilisant l’extension de Traduction de contenu.
- cxpublishsection
- Interne. Enregistrer une section créée en utilisant la fonctionnalité de traduction de section de l’extension Traduction de contenu.
- cxsave
- Interne. Ce module permet d’enregistrer les brouillons de traduction par section pour économiser la bande passante et élaborer un corpus parallèle.
- cxsplit
- Interne. Créez et enregistrez une traduction de section dans la base de données, pour chaque section traduite de la traduction d'un article donné
- discussiontoolscompare
- Interne. Obtient des informations au sujet des changements de commentaire entre deux révisions de page.
- discussiontoolspageinfo
- Interne. Retorna les metadades necessàries per activar les Eines de Discussió.
- discussiontoolspreview
- Interne. Afficher l’aperçu d’un message sur une page de discussion.
- echopushsubscriptions
- Interne. Gérer les abonnements de poussée d’informations pour l’utilisateur actuel.
- editcheckreferenceurl
- Interne. Check the status of a URL for use as a reference.
- fancycaptchareload
- Interne. Obtenir un nouveau FancyCaptcha.
- growthinvalidateimagerecommendation
- Interne. Invalider une recommandation d’image.
- growthinvalidatepersonalizedpraisesuggestion
- Interne. Invalide une suggestion de tutoré digne de félicitation dans le module de félicitations personnalisé sur le tableau de bord du tuteur
- growthinvalidaterevisetonerecommendation
- Interne. Abandonner une recommandation de « Révision du ton » pour une page donnée.
- helppanelquestionposter
- Interne. Atén preguntes fetes a través del Plafó d'Ajuda per l'usuari actual.
- jsondata
- Interne. Récupérer les données JSON régionalisées.
- jsontransform
- Interne. Récupérer les données JSON transformées par une fonction Lua.
- parser-migration
- Interne. Analyser une page avec deux configurations d’analyseur différentes.
- readinglists
- Interne. Opérations d’écriture des listes de lecture.
- sanitize-mapdata
- Interne. Effectue la validation des données pour l’extension Kartographer
- scribunto-console
- Interne. Module interne pour répondre aux requêtes XHR à partir de la console Scribunto.
- securepollauth
- Interne. Autorise un wiki distant à authentifier les utilisateurs avant d’accorder l’accès et leur permettre de voter à l’élection.
- stashedit
- Interne. Préparer des modifications dans le cache partagé.
- sxsave
- Interne. Enregistrer la traduction de section en brouillon et stocke le corpus parallèle.
- timedtext
- Interne. Fournit un contenu texte horodaté pour être utilisé par les éléments $lt;track>
- ulslocalization
- Interne. Obtenir la traduction de ULS dans la langue donnée.
- ulssetlang
- Interne. Mettre à jour la langue d’interface préférée de l’utilisateur.
- visualeditor
- Interne. Renvoie une page HTML5 du service Parsoid.
- visualeditoredit
- Interne. Enregistrer une page HTML5 en MediaWiki (convertie en wikicode via le service Parsoid).
- wikimediaeventsblockededit
- Interne. Tracer les informations sur les tentatives de modification bloquées
- wikimediaeventshcaptchaeditattempt
- Interne. Log edit diff when hCaptcha challenge is shown but edit is incomplete
- Une des valeurs suivantes : abusefiltercheckmatch, abusefilterchecksyntax, abusefilterevalexpression, abusefilterunblockautopromote, abuselogprivatedetails, acquiretempusername, antispoof, block, centralauthtoken, centralnoticecdncacheupdatebanner, centralnoticechoicedata, centralnoticequerycampaign, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, communityconfigurationedit, compare, createaccount, createlocalaccount, cxdelete, cxtoken, delete, deleteglobalaccount, discussiontoolsedit, discussiontoolsfindcomment, discussiontoolsgetsubscriptions, discussiontoolssubscribe, discussiontoolsthank, echocreateevent, echomarkread, echomarkseen, echomute, edit, editmassmessagelist, emailuser, expandtemplates, featuredfeed, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, globalblock, globalpreferenceoverrides, globalpreferences, globaluserrights, growthmanagementorlist, growthmentordashboardupdatedata, growthsetmenteestatus, growthsetmentor, growthstarmentee, help, homepagequestionstore, imagerotate, import, jsonconfig, languagesearch, linkaccount, login, logout, managetags, massmessage, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setglobalaccountstatus, setnotificationtimestamp, setpagelanguage, shortenurl, sitematrix, spamblacklist, streamconfigs, strikevote, sxdelete, tag, templatedata, thank, titleblacklist, torblock, transcodereset, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, webapp-manifest, webauthn, bouncehandler, categorytree, chartinfo, cirrus-check-sanity, cirrus-config-dump, cirrus-profiles-dump, cirrus-schema-dump, codemirror-validate, collection, cspreport, cxcheckunreviewed, cxfavoritesuggestions, cxpublish, cxpublishsection, cxsave, cxsplit, discussiontoolscompare, discussiontoolspageinfo, discussiontoolspreview, echopushsubscriptions, editcheckreferenceurl, fancycaptchareload, growthinvalidateimagerecommendation, growthinvalidatepersonalizedpraisesuggestion, growthinvalidaterevisetonerecommendation, helppanelquestionposter, jsondata, jsontransform, parser-migration, readinglists, sanitize-mapdata, scribunto-console, securepollauth, stashedit, sxsave, timedtext, ulslocalization, ulssetlang, visualeditor, visualeditoredit, wikimediaeventsblockededit, wikimediaeventshcaptchaeditattempt
- Per defecte: help
- format
Lo format de sortida.
- 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
- Per defecte: 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.- Tipus: enter
- 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.- Tipus: enter
- La valeur ne peut pas être inférieure à 0.
- Per defecte: 0
- maxage
Fixer l’entête HTTP de contrôle de cache
max-ageau nombre indiqué de secondes. Les erreurs ne sont jamais mises en cache.- Tipus: enter
- La valeur ne peut pas être inférieure à 0.
- Per defecte: 0
- assert
Vérifiez que l’utilisateur est connecté (y compris éventuellement en tant qu’utilisateur temporaire) s’il est défini sur user, qu’il n’est pas connecté s’il est défini sur anon, ou qu’il dispose des droits d’utilisateur du bot s’il est bot.
- Une des valeurs suivantes : anon, bot, user
- assertuser
Verificar l'utilizaire actual es l'utilizaire nomenat.
- Tipus: usuari, per qualsevol de Nom d'utilizaire e Usuari temporal
- 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’orodatatge actual dins lo resultat.
- 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’URL 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êteOriginet l’origine indiquée est autorisée, l’API renseignera les entêtesAccess-Control-Allow-OriginetAccess-Control-Allow-Credentialsdans sa réponse.Pour les requêtes non authentifiées, indiquez la valeur *. L’API renseignera l’entête
Access-Control-Allow-Origindans sa réponse, maisAccess-Control-Allow-Credentialsvaudrafalseet toutes les données spécifiques à l’utilisateur seront restreintes.- crossorigin
Lorsque vous accédez à l’API à l’aide d’une requête AJAX inter-domaines (CORS) et que vous utilisez un fournisseur de session protégé contre les attaques CSRF (cross-site request forgery) (comme OAuth), utilisez ceci à la place de
origin=*pour authentifier la requête (c’est-à-dire, sans déconnexion). Cela doit être inclus dans toute requête préalable et doit donc faire partie de l’URL de la requête (et non du corps POST).Notez que la plupart des fournisseurs de session, y compris les sessions standard basées sur les témoins (cookies), ne prennent pas en charge CORS authentifié et ne peuvent pas être utilisés avec ce paramètre.
- Type : booléen (détails)
- uselang
Langue à utiliser pour les traductions de message. action=query&meta=siteinfo&siprop=languages renvoie une liste de codes de langue. Vou pouvez indiquer 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.
- Per defecte: 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
- Per defecte: bc
- errorlang
Langue à utiliser pour les avertissements et les erreurs. action=query&meta=siteinfo&siprop=languages renvoie une liste de codes de langue. Vous pouvez utiliser content pour utiliser la langue du contenu de ce wiki, ou encore uselang pour utiliser la même valeur que le paramètre uselang.
- Per defecte: 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)
- centralauthtoken
Lors de l’accès à l’API en utilisant une requête AJAX inter-domaines (CORS), utiliser ceci pour s’authentifier comme l’utilisateur SUL actuel. Utiliser action=centralauthtoken sur ce wiki pour récupérer le jeton, avant de faire la requête CORS. Chaque jeton ne peut être utilisé qu’une fois et expire après 10 secondes. Cela devrait être inclus dans toute requête de survol préalable et donc dans l’URI de la requête (et non le corps du POST).
On this wiki the expected value is a JSON Web Token, which may be validated by proxy servers in front of MediaWiki. If the token has expired or is otherwise invalid, you may receive a HTTP error from a proxy in a different format than a normal API error.
- Aide pour le module principal.
- api.php?action=help [ouvrir dans le bac à sable]
- Tota l'ajuda sus una pagina.
- api.php?action=help&recursivesubmodules=1&toc [ouvrir dans le bac à sable]
Mercejaments
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/.
