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.
 * API use in visualizing data obtained from a wiki. Such as this neat visualization that shows real time edits made on Wikipedia.



Notes supplémentaires

 * Several sites are using MediaWiki. They might all be running a different version of MediaWiki and in turn the API. Some module parameters supported in one version might be deprecated or removed in others. You could learn about that in each module's documentation via API help module.
 * If you want to make a lot of API calls, and perhaps run very busy and active bots, talk to wiki admins ahead of time, so they do not block you. See list of Administrators of Wikimedia projects. Read more about this topic on.
 * All data modifying actions such as logging, editing or moving a page, and watching or patrolling changes would require tokens. You would need to obtain tokens via to proceed further.

Ressources

 * Use Special:APISandbox to experiment with the Action API. You can play around with supported actions, specify a value for parameters, and send requests to the API to see the results on the same page.
 * 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