L'API REST, la toute-puissante !
Les API REST sont les plus répandues sur le web. Découvrez dans ce chapitre quelles sont les spécificités des API REST par rapport aux autres API et comment elles fonctionnent. C'est parti ! :D
Qu'est-ce qu'une API REST ?
Ce type d'API permet à des logiciels qui sont incompatibles, qui ne parlent pas le même langage, de communiquer facilement. REST peut être considéré comme un langage commun à ces différents logiciels. Par exemple, une API REST peut être réalisée dans le langage Java ou .NET.
Des exemples d'utilisation de l'API REST dans votre quotidien !
Vous souhaitez accéder à des comptes utilisateurs, à des photos, à des tags et bien plus encore depuis votre application ? L'API d'Instagram vous le permettra !
Pour plus d’informations, vous pouvez consulter la documentation d'Instagram.
GitHub
GitHub est un réseau social pour les développeurs. Son API REST vous permet de suivre l’activité d’un utilisateur, de consulter les bugs d’un dépôt et même de créer un dépôt depuis votre application. Si vous voulez vous créer un site portfolio qui va chercher automatiquement les projets de votre compte pour les afficher sur votre site, vous pouvez utiliser l'API de GitHub.
Pour plus d’informations, vous pouvez consulter la documentation de GitHub.
Gmail
L'API Gmail vous permet de lire et d'envoyer des messages, gérer les brouillons et les pièces jointes, rechercher des fils de discussion et des messages, utiliser des libellés, configurer les notifications push et gérer les paramètres Gmail.
Pour avoir plus d’informations, vous pouvez consulter la documentation de l'API Gmail ici.
ArcGIS
Utilisez les API REST facilement dans votre projet
REST a été conçu pour répondre aux besoins spécifiques du web. REST est donc basé sur le standard URI (Uniform Resource Identifier) qui correspond à une chaîne de caractères identifiant une ressource web. Par exemple, une URL est une URI, elle identifie une ressource web, une page web par exemple. Ce standard est plus intuitif pour vous développeur, ce qui vous permet d'être plus productif ! :D
De plus, les API REST reposent sur le protocole HTTP, très simple d'utilisation pour tous les logiciels.
Les différentes contraintes imposées par l'architecture REST en font des applications de meilleure qualité.
L'API REST est performante car beaucoup de clients peuvent se connecter sur un serveur à la fois.
Aussi, utilisez REST dans votre projet informatique pour sa simplicité de mise en œuvre, sa plus grande tolérance à la panne (un serveur peut être en panne mais un autre pourra vous répondre), et donc sa fiabilité !
Tous ces avantages font de l'API REST la plus populaire du web et le choix idéal pour vos projets informatiques.
Programmez simplement avec l'API REST
Vous connaissez à présent les fondements de l'API REST, vous allez étudier maintenant sa mise en œuvre.
Manipulez les ressources avec les verbes HTTP
L'API REST est une architecture qui repose sur le protocole HTTP, c'est-à-dire que l'API REST permet d'accéder à un service web via les 4 opérations de HTTP, ou verbes (POST, GET, PUT, DELETE). Ces opérations ont donc 4 fonctions résumées par l'acronyme CRUD (Create, Read, Update, Delete) :
opération HTTP "POST".
Fonction : créer (Create) : permet de créer une ressource ;opération HTTP "GET".
Fonction : afficher (Read) : permet de lire une ressource ;opération HTTP "PUT".
Fonction : mettre à jour (Update) : permet de modifier la valeur d'une ressource ;opération HTTP "DELETE".
Fonction : supprimer (Delete) : permet de supprimer une ressource sur le serveur.
Exemples d'URL
Imaginons que vous ayez un site qui permet de gérer des timbres en ligne. Le timbre, c'est votre ressource. Il est donc identifié par une URL, et on pourra utiliser des verbes HTTP pour exécuter des actions sur ce timbre :
pour créer un timbre, pas besoin d'avoir l'URL de la ressource, vous pourrez par exemple utiliser :
POST http://monsiteweb.fr/stamps. À ce moment-là, le serveur vous répondra sûrement avec l'identifiant du timbre créé. Par exemple 183 ;pour afficher le timbre 183, vous pourrez utiliser :
GET http://monsiteweb.fr/stamps/183pour mettre à jour le timbre 183 :
PUT http://monsiteweb.fr/stamps/183enfin, pour supprimer le timbre 183 :
DELETE http://monsiteweb.fr/stamps/183.
Vous savez utiliser ces 4 opérations ? Bravo, vous savez programmer avec une API REST !
Testez un service REST
Pour tester un service REST, vous pouvez utiliser votre navigateur web (au moins pour les requêtes GET).
Par exemple, l'exécution de l'URL suivante renvoie plein d'informations :
Pour les voir, c'est très simple, cliquez sur le lien ! Votre navigateur enverra la requête et recevra les informations fournies par ArcGIS. ;)
Dans ces informations, vous allez trouvez les coordonnées X,Y de l'adresse : 10 avenue des Champs-Élysées à Paris.
Pour récapituler, les API REST sont un type d'architecture d'API qui a été construit pour le web. Il utilise le protocole HTTP et des URI (comme par exemple des URL) pour identifier les ressources. Avec HTTP, vous pouvez donc utiliser 4 opérations (ou verbes) pour manipuler vos ressources via une API : GET, POST, PUT et DELETE.
Bravo, vous êtes maintenant familier avec les API, et l'API REST plus particulièrement. Mais pourquoi REST et pas une autre API ? C'est ce que vous allez apprendre dans le chapitre suivant !
