8. Exemple d’utilisation d’une API REST

Alors, nous avons dû assimiler un paquet de nouveaux concepts, depuis le début de notre apprentissage des APIs Rest. Mais pour vraiment être sûr d’avoir bien compris tout ça, rien de tel qu’un peu de pratique !

Je vous propose donc de tester le fonctionnement d’une API Rest déjà existante, car pour le moment nous n’avons pas encore crée la nôtre malheureusement !

En gros, voici ce qu’on va essayer de faire :

On va envoyer une requête, ici on a un exemple fictif avec GET « /users/1« . Et en réponse, on s’attend à des données JSON, contenant les informations demandées.

Afin de voir comment cela fonctionne sur un exemple plus pratique, nous allons utiliser l’API Rest de Github. C’est un service en ligne proposant d’héberger le code des développeurs. Une sorte de Google Drive pour geeks si vous voulez. 🙂

Et devinez qui utilise Github ? Et bien Node.js ! En effet, le code de Node.js est directement accessible en ligne sur ce site : github.com/nodejs.

On y retrouve le code de Node.js en tant que tel, ainsi que plusieurs autres projets annexes maintenus par les contributeurs derrières Node.js. En fait, c’est la page de l’organisation qui gère le projet Node.js.

On va donc essayer de passer par l’API Rest pour obtenir ces mêmes informations, mais sous forme d’une réponse JSON, plutôt que d’une belle page web HTML.

Mais… Comment on va pouvoir utiliser l’API Rest de Github ? On ne connait pas grand-chose encore ! 🤯

Et bien, en fait les données publiques d’un site sont souvent mise à disposition via l’API Rest de ce même site. Quand on y réfléchit bien, c’est assez logique :

  • Si vous utilisez votre navigateur pour aller sur la page web de l’organisation de Node.js, techniquement votre navigateur va effectuer une requête de type GET, et récupérer une réponse HTML avec le type MIME « text/html« . Essayez tout de suite en vous rendant à l’adresse github.com/nodejs :
Sur le site de l’organisation Node.js, on découvre qu’il y a plus de 173 projets maintenus !
  • Si vous utilisez votre navigateur pour aller sur l’API Rest de l’organisation Node.js, techniquement votre navigateur va effectuer une requête de type GET, et récupérer une réponse JSON avec le type MIME « application/json« . Pas besoin de me croire sur parole, rendez-vous à l’adresse api.github.com/users/nodejs :
Sur l’API Rest de l’organisation Node.js, on découvre qu’il y a également 173 projets maintenus !

Donc, on a exactement les mêmes informations, mais présentés sous deux formes : une belle interface pour les gens normaux, et une réponse JSON bizarroïde pour les développeurs comme nous. 😇

Au départ, cela peut vous mettre une sacré claque, mais prenez le temps d’assimiler votre découverte. Petit à petit, vous allez vous enfoncer dans le monde sans fin du développement backend… Tenez vous prêt pour la suite !

En tout cas, vous savez maintenant effectuer des requêtes GET vers une API Rest, et récupérer des réponses JSON, simplement avec votre navigateur. Bravo !