Description du cours
REST est un style d’architecture API qui s’appuie fortement sur les normes de l’industrie ainsi que sur les concepts fondamentaux qui alimentent Internet. Cette approche permet des modèles d’utilisation communs et reproductibles et correspond aux normes largement acceptées pour l’accès aux API et la documentation. De nombreux modules et modèles prêts à l’emploi existent pour les API REST, mais il est également possible, et en fait courant, que les API REST soient créées à partir de zéro.
Il existe de nombreux formats de documentation des API, mais le plus courant et peut-être le plus facile à utiliser s’appelle OpenAPI. Il permet aux propriétaires d’API REST de publier une documentation interactive générée automatiquement en fonction des fonctionnalités de l’API. Vous apprendrez à lire la documentation OpenAPI et à exécuter des tests d’API directement à partir de celle-ci.
Les types les plus courants d’actions d’API et de méthodes HTTP sont couverts, y compris les opérations de lecture à l’aide de la méthode GET, les opérations d’envoi à l’aide de la méthode POST et les méthodes de mise à jour à l’aide des méthodes PUT, PATCH et DELETE.
Ce que vous allez apprendre
- Décrire l'objectif et le format de la documentation OpenAPI, y compris comment la lire et exécuter des tests d'API directement à partir d'elle
- Lister et décrire les méthodes HTTP les plus courantes utilisées avec les API REST
- Effectuer des opérations de lecture en comprenant comment les requêtes GET reçoivent les données des API REST
- Envoyer et mettre à jour des données en identifiant comment les requêtes d'écriture (write requests) transmettent les corps de requête (request bodies) aux API REST
- Utiliser les requêtes POST pour envoyer des opérations aux API REST
- Mettre à jour l'état de l'objet à l'aide des méthodes PUT, PATCH et DELETE
Points clés à retenir
- REST est un style architectural d'API qui repose sur les normes de l'industrie et les concepts fondateurs qui animent Internet, permettant des modèles d'utilisation communs et reproductibles.
- Les API REST peuvent être construites à l'aide de modules et de modèles (templates) pré-emballés, mais il est également courant de les créer de toutes pièces.
- OpenAPI est le format de documentation d'API le plus courant et sans doute le plus facile, et il permet aux propriétaires d'API REST de publier une documentation interactive générée automatiquement en fonction des capacités de l'API.
- GET est utilisé pour les opérations de lecture, POST est utilisé pour les opérations d'envoi, et PUT, PATCH et DELETE sont utilisés pour les opérations de mise à jour.
- Les requêtes d'écriture envoient des corps de requête aux API REST, tandis que les requêtes GET reçoivent des données de celles-ci.
Foire aux questions
Que couvre ce cours ?
Il couvre le style architectural des API REST, comment lire la documentation OpenAPI et y exécuter des tests d'API, ainsi que les actions d'API et les méthodes HTTP les plus répandues, notamment GET pour les opérations de lecture, POST pour les opérations d'envoi, et PUT, PATCH et DELETE pour les opérations de mise à jour.
Quelles méthodes HTTP vais-je découvrir ?
Le cours aborde les méthodes HTTP les plus courantes, y compris la méthode GET pour lire des données, la méthode POST pour envoyer des données, et les méthodes PUT, PATCH et DELETE pour mettre à jour l'état de l'objet.
Qu'est-ce qu'OpenAPI et comment est-il utilisé dans ce cours ?
OpenAPI est le format de documentation d'API le plus courant, permettant aux propriétaires d'API REST de publier une documentation interactive qui est automatiquement générée en fonction des capacités de l'API. Dans ce cours, vous apprendrez à lire la documentation OpenAPI et à exécuter des tests d'API directement depuis celle-ci.
Quelles leçons sont incluses dans ce cours ?
Le cours comprend quatre leçons : La documentation OpenAPI, Les requêtes GET, Les requêtes POST, et La mise à jour de l'état de l'objet à l'aide des méthodes HTTP.
Quelles compétences ce cours aide-t-il à développer ?
Il soutient des compétences telles que la conception d'API, la gestion d'API, le développement d'API REST, les API RESTful, le client REST et le client REST avancé.
