Médias
Comprendre ce qu'est une API
Utiliser une API
Introduction
Tu as vu dans un article précédent (Web 2.0) ce qu'était le Web 2.0. Brièvement on peut dire que c'est toi qui deviens acteur/rédacteur/organisateur du web : tu peux créer du contenu très facilement, le modifier et le présenter d'une manière qui te convient.Il y a un autre point qui est intéressant avec le Web 2.0 : l'ouverture des applications. La plupart des applications Web sont désormais "ouvertes" : cela veut dire que le contenu que tu lis habituellement sur un site peut être récupéré voire modifié à partir d'un autre site ou d'une autre application. Et cela se déroule à travers les API.
API, joyeux mot ?
API est l'acronyme des termes anglais Application Programming Interface (Interface de programmation). Cela te permet d'accéder à une application, à ces données et ces fonctionnalités, en dehors de cette application. Dans le cadre du Web, ces API sont généralement ce que l'on appelle des Web Services : tu lances une requête HTTP sur un site Web avec les bons paramètres et tu as un résultat. Pour en parler plus concrètement, nous allons analyser quelques exemples de site mettant à disposition des API ou exploitant les API d'autres sites.Une API doit rester simple pour faciliter son utilisation et assez complète pour permettre le maximum d'opération. On préférera en général limiter le nombre d'opérations et plutôt les rendre assez générale.
Exemples de site
- Netvibes : ce site se veut être un bureau virtuel où tu peux centraliser tous ce que tu fais sur le Web. Il est composé de différents composants, tous exploitants les API des sites sur lequel il récupère ses informations (le widget Google News se connect sur le serveur Google News pour récupérer les informations à afficher)
- Twitter : un site de micro-blogging (un mélange entre le blog et le SMS) assez populaire. L'API permet ici aussi d'accéder aux "Twits" (articles) postés, d'en ajouter, etc. Il existe aussi une panoplie d'application utilisant l'API de Twitter. C'est d'ailleurs en grande partie grâce à cette ouverture que Twitter est devenu populaire.
- Yahoo! Music : Yahoo a tenté pendant quelques temps de vendre de la musique en ligne. Cela n'a pas fonctionné mais désormais il donne libre accès à sa base de données sur les artistes, albums, etc. La documentation de l'API est disponible ici (en anglais).
Un peu de pratique
Essayons de récupérer les derniers Twits de Twitter. En lisant la documentation, on voit qu'il suffit de lancer une requête HTTP GET sur http://twitter.com/statuses/public_timeline.xml. La requête HTTP GET, c'est simplement la requête qui est lancée par ton navigateur Internet quand tu tapes une adresse Web dans la barre d'adresse. Donc pour récupérer les derniers Twits, il suffit de copier-coller l'adresse http://twitter.com/statuses/public_timeline.xml dans la barre d'adresse et d'appuyer sur entrée. Dans ce cas, on récupère un fichier XML contenant toutes les informations des derniers Twits. Tu peux l'examiner plus en détail en affichant la source de la page (CTRL+U sous Firefox).C'est un exemple très simple mais cela montre bien qu'il n'est pas très difficile d'utiliser les API du moment que les standards sont suivis.
Standard
Pour faciliter la communication entre les différentes applications Web, il existe quelques standards qu'il est intéressant d'étudier :- REST : défini une architecture très simple pour récupérer/modifier du contenu
- Le protocole HTTP fournit les métodes nécessaires à toutes les actions possibles sur un site (GET, POST, PUT, DELETE sont majoritairement utilisés)
- Une ressource Web (un article par exemple) doit être accessible par une URI (une adresse unique)
- Des technologies standards telles que XML ou HTML doivent être utilisées pour faire circuler l'information
- SOAP/XML-RPC : défini une structure pour XML permettant de décrire des services Web. Très lourd à mettre en place mais très complet. C'est vraiment intéressant pour de grosses applications complexes composées d'une multitude de petis éléments
- Unicode : norme de codage de caractère. Il existe plusieurs façons d'encoder des caractères en Unicode. La plus fréquemment utilisée est nommée UTF-8 (encodage des caractères sur 8 ou 16 bits)
Les API permettent d'utiliser ou d'étendre des applications ou de créer de nouvelles applications. Il est d'autant plus facile de le faire que les standards sont utilisés.
