Introduction
C'est quoi un service web (API)?
L'acronyme API signifie en anglais Application Programming Interface. On peut définir une api comme un interface qui permet d’échanger de l’informations avec d’autres applications, peut importe le langage de programmation et le système d’exploitation.
Il existe plusieurs types d'architectures d'api. Nous allons apprendre l'architecture REST qui se base sur les standards du web et le protocole HTTP.
Court résumé en 4 minutes
Fonctionnement général
Notre api va recevoir des requêtes HTTP qui seront traitées selon les paramêtres envoyés et retournera ensuite une réponse à la requête.
Une requête à un api REST va toujours être composée de quatre parties essentielles:
- Method : Une méthode HTTP: GET, POST, PUT, PATCH, DELETE.
- Endpoint : Une porte d'entrée (endpoint), le plus souvent sous la forme d'une url.
- Headers : Une entête à la requête HTTP qui contient plusieurs informations comme les informations de l'usager et une clé d'api.
- Body : Un "corps" qui peut contenir des informations a envoyé à l'api.
Envoyer une requête
On peut envoyer une requête à un api depuis n'importe quel navigateur mais nous n'aurons pas de contrôle sur les informations envoyé et on sera limité à la méthode GET.
Il existe plusieurs outils qui nous permettent une utilisation plus poussé des apis, Postman en est un bon exemple. Sinon on peut incorporé le tout dans une application ou page web, la plupart des langages de programmation prennent en charge les requêtes HTTP.