API:Tutorial/fr

Dans ce tutoriel, vous découvrirez ce qu'est l' API Action de MediaWiki, comment l'utiliser, le format des requêtes, une requête simple et des exemples de projets qui utilisent l'API Action.

Voir les applications de démonstration sur Toolforge



Aperçu de l'API Action de MediaWiki
L' API Action de MediaWiki est un service web utilisant REST et qui permet aux utilisateurs de réaliser certaines actions sur les wikis telles que la création de page, l'authentification, l'analyse syntaxique, la recherche, etc. est un bon point d'entrée pour comprendre l'API.

Votre programme envoie des requêtes à l'API pour avoir accès aux fonctionnalités du wiki. Par exemple se connecter à un wiki, créer ou modifier une page, rechercher un titre, chercher une texte dans le contenu, ou analyser un contenu. L'API Action est disponible pour les développeurs tiers, les développeurs d'extensions Wikimedia, et les administrateurs de site.

Dans la barre latérale droite de cette page il existe plusieurs fonctions réalisées par l'API et groupées par catégorie. Avant d'envoyer les requêtes à un serveur wiki, lisez d'abord les pages de présentation telles que les formats des données, les erreurs et les avertissements, et la FAQ de l'API Action.



Comment utiliser l'API Action de MediaWiki
Vous pouvez demander des données sur le serveur à partir d'un client avec le protocole HTTP et obtenir en retour la réponse dans un format standard (typiquement en JSON). Une requête est constituée d'un point d'accès et d'une série de paramètres. Vous pouvez utiliser deux types de requêtes : GET et POST. Dans une requête GET, un paramètre contient la chaîne de caractères de la requête dans l'URL. Dans les requêtes POST, mettez les paramètres au format JSON.



Format de la requête
Tous les Wikis Wikimedia possèdent des points d'accès de ce format. Pour opérer sur le site principal de MediaWiki ou celui de la Wikipedia anglophone, utilisez le point d'accès qui lui correspond. Par exemple, la Wikipedia anglophone se trouve sur. Pour tester de nouveaux comptes ou pour tester les modifications de pages, utilisez le point d'accès du wiki de test.

Dans l'URL de la chaîne de la requête, ajoutez le paramètre. Il indique à l'API l'action à réaliser. L'action la plus populaire est  (l'URL va contenir ), ce qui permet de rechercher des données dans un wiki. Après le paramètre, ajoutez un autre paramètre pour indiquer quel type de module de recherche parmi les trois vous voulez exécuter :


 * - obtenir les propriétés des pages
 * - obtenir la liste des pages qui vérifient un certain critère
 * - obtenir les méta informations concernant le wiki et les utilisateurs

Enfin, ajoutez le paramètre, qui indique à l'API dans quel format les résultats doivent être fournis. Le format recommandé est JSON. Dans le passé, l'API prenait en charge d'autres formats de sortie, mais il est recommandé de ne plus les utiliser.



Une requête simple
Prenons un exemple d'une requête simple pour comprendre à quoi ressemble une requête GET typique ainsi que sa réponse dans le contexte de l'API Action.

Essayons de chercher un titre dans un wiki. Nous utiliserons le module  documenté sur.



Requête GET
Pour rechercher des titres de pages ou du contenu qui avec, l'URL de la requête HTTP GET sera :Explication de chaque partie de l'URL :


 * est le point d'accès principal. Dans ce cas il s'agit de la Wikipedia anglophone.
 * signifie rechercher les données dans le wiki.
 * signifie obtenir la liste des pages qui vérifient un critère.
 * indique le titre la page ou le contenu à rechercher. Le  représente un caractère espace dans une URL.
 * indique la sortie en JSON, qui est le format de sortie recommandé.

Réponse
La réponse est un document au format JSON avec une liste de titres des pages qui correspondent à Craig Noone :



Exemples de projets qui utilisent l'API Action
Exemples de projets de Wikimedia qui utilisent l'API Action :


 * Appli Wikipedia iOS, dont l'une des fonctionnalités est de rechercher des pages wiki en rapport avec le voisinage de votre emplacement.
 * Robots qui opèrent sur un wiki. Pywikibot est un environnement pour les robots, écrit en Python, et qui s'interface avec l'API MediaWiki utilisée par beaucoup de développeurs de robots.
 * L'utilisation de l'API permet de visualiser les données obtenues d'un wiki. Comme cette visualisation soignée montrant les éditions en temps réel les modifications faites sur Wikipedia.



Notes supplémentaires

 * Plusieurs sites utilisent MediaWiki. Il est possible qu'il exécutent des versions différentes de MediaWiki et donc de l'API. Certains paramètres de module pris en charge dans une version peuvent être obsolètes ou supprimés dans une autre. Vous pouvez le savoir en regardant la documentation de chaque module via le module d'aide de l'API.
 * Si vous souhaitez réaliser un grand nombre d'appels à l'API, et peut être exécuter des robots très occupés et actifs, parlez-en d'abord aux administrateurs du wiki, afin qu'ils ne vous bloquent pas. Voir la liste des Administrateurs des projets Wikimedia. Lire les autres informations sur ce sujet sur.
 * Toutes les actions de modification des données comme la journalisation, la modification ou le renommage d'une page ainsi que le suivi ou les modifications du patrouillage nécessitent des jetons. Il vous faudra obtenir des jetons via pour pouvoir continuer.

Ressources
Vous pouvez tester en essayant les actions prises en charge, en spécifiant la valeur des paramètres, et en envoyant les requêtes à l'API pour voir les résultats sur la même page.
 * Utilisez Special:APISandbox pour essayer l'API Action.
 * Vidages Wikimedia pour les analyser localement.
 * Lisez les tutoriels : Introduction aux APIs et REST c'est quoi ?  —  une explication simple pour les débutants.
 * API help de MediaWiki fournit la documentation auto générée de l'API de tous les modules pris en charge.
 * fournit un aperçu de l'API Action.
 * Introduction à l'API MediaWiki par User:Roan_Kattouw_(WMF) au Hackathon de San Francisco, 2012. Ce tutoriel suit la vidéo.
 * GitHub: Démonstrations de l'API MediaWiki