Wikimedia REST API
Wikimedia REST API permet d’accéder au contenu et aux métadonnées de Wikimedia dans des formats lisibles par machine. Axé sur les cas d’utilisation à grand volume, il s’intègre étroitement avec l’infrastructure de cache distribuée mondialement de Wikimedia. Par conséquent, les utilisateurs de l’API bénéficient de latences réduites et d’une prise en charge des volumes de requêtes élevés.
L’API REST avec sa documentation est disponible pour tous les grands projets Wikimedia à l’emplacement /api/rest_v1/. Par exemple, pour le Wikipedia anglais, il est disponible à https://en.wikipedia.org/api/rest_v1/.
Bien que la fonctionnalité offerte par la plupart des projets corresponde étroitement que sur Wikipédia anglais, il y a quelques exceptions notables :
- wikimedia.org offre des informations inter-projets comme les statistiques de vues des pages.
- fr.wiktionnary.org offre un point d'extrémité de définition, avec des informations Wiktionnaire en données structurées. Du support pour d'autres langages en en cours de discussion.
Versionnement
L'API REST obéit à cette politique de versionnage d'API.
Termes et Conditions d'utilisation
- En utilisant l'API REST, vous acceptez les Conditions d'Utilisation générales et la Politique de Confidentialité de Wikimedia.
- Pour éviter de gêner les autres utilisateurs d'API, limitez vos clients à pas plus de 200 requêtes/seconde à cet API au total. De nombreux points d'entrée spécifient et appliquent d'autres limites de taux plus restrictives.
- Nous vous demandons de configurer un en-tête
User-Agent
ouApi-User-Agent
qui nous permet de vous contacter rapidement. Vous pourriez par exemple donner un email ou l'URL d'une page de contact.
Autres APIs
Pour l'API REST fournie avec MediaWiki 1.35 et ultérieur, voir l'API REST du nayou MediaWiki.
API | Disponibilité | Base de l'URL | Exemple |
---|---|---|---|
API Action de MediaWiki | Inclus dans MediaWiki
Activé sur les projets Wikimedia |
/api.php | https://fr.wikipedia.org/w/api.php?action=query&prop=info&titles=Terre |
API REST de MediaWiki | Inclus dans MediaWiki 1.35+
Activé sur les projets Wikimedia |
/rest.php | https://fr.wikipedia.org/w/rest.php/v1/page/Terre |
Wikimedia REST API | Non inclus dans MediaWiki
Disponible uniquement dans les projets Wikimedia |
/api/rest | https://fr.wikipedia.org/api/rest_v1/page/title/Terre |
Pour des API des projets Wikimedia dimensionnés pour un usage commercial, suivez le lien Wikimédia Enterprise |
Voir aussi
- RESTBase (obsolescence en cours), la technologie derrière l'API REST
- Post de blog annonçant la version 1.0. Décrit plusieurs cas d'utilisation de production majeurs, évoque comment l'API REST s'inscrit dans la stratégie technique générale de Wikimedia, et fournit des indications pour quelques détails d'implémentation.
- L'API est implémenté en utilisant Node.js. Ce post de blog décrit notre expérience de la mise à jour de l'API REST et d'autres services à Node 6.
- Équipe MediaWiki Platform, propriétaires du produit pour l'API REST.
- Core Platform Team/Initiatives/API Gateway (2020)