Considérations de conception des API REST

Name: Considérations de conception des API REST
Author: Josh Guardino

Découvrez comment exécuter des API REST dans le cloud et gérer les modifications

Preview the first lesson free — get full access to all 3 lessons.

Cours : à la demande

Bonjour, je m'appelle Josh Gardino, et dans ces leçons, vous apprendrez sur les considérations de conception de l'API REST. Commençons par explorer les API REST dans le cloud. Presque toutes les nouvelles API sont conçues et déployées aux clouds publics, et de nombreuses API héritées ont été ou seront bientôt migrés vers le cloud. Les avantages du cloud public sont nombreux. Pour les fournisseurs d'API, cela signifie qu'ils n'ont pas besoin de se préoccuper du matériel physique ou l'hébergement d'API ou de services auxiliaires tels que des bases de données. Tout cela peut être fait dans le cloud public et configuré via une console Web. Chacun des principaux fournisseurs de cloud public propose une suite d'outils pour aider avec l'hébergement d'API, la livraison, la sécurité et l'activation du cloud. Amazon Web Services ou AWS propose également une API Gateway. Et encore une fois, avec une prise en charge complète des API RESTful. Explorons le service AWS API Gateway. Nous allons commencer par créer une API. Appelons cela test et examinons certains détails. AWS lui attribue un ID unique, une URL racine et une étape par défaut. Commençons donc par créer une racine et une méthode. Toutes les méthodes HTTP habituelles sont affichées. Alors sélectionnons GET et nous définirons également un chemin /drivers sur lequel nous pouvons déployer notre API Department of Motor Vehicles où les services REST sous les pilotes. Nous avons donc maintenant la route /drivers configurée avec un point de terminaison de méthode GET. Ce chemin serait maintenant disponible pour être appelé par un client API REST, mais il ne peut pas faire grand-chose par lui-même. Afin d'ajouter des fonctionnalités, nous devons joindre une intégration. Les intégrations impliquent d'autres services AWS qui fournira la logique métier exécutée lorsque le point de terminaison de l'API REST est appelé. Le type d'intégration le plus courant, et celui que nous utiliserons ici est AWS Lambda. Les Lambda sont des processus légers sans serveur qui prennent en charge une grande variété de langages de programmation. Et j'ai une configuration Lambda existante appelé drivers-get-lambda. Et ce Lambda est suggéré comme point d'intégration. Alors allons-y et sélectionnons-le. Et maintenant, le point de terminaison GET est étiqueté avec AWS Lambda ainsi toutes les demandes au point de terminaison GET seront transmises à la Lambda. Le Lambda que nous allons utiliser ici est un Node.js très simple, JavaScript Lambda. Tout ce que ce Lambda fait lorsqu'une demande arrive est de retourner un tableau JSON contenant tous les pilotes. Pour plus de simplicité, nous l'avons codé en dur ici. Alors maintenant que nous avons créé notre instance API Gateway, un point de terminaison /drivers GET configuré et une fonction Lambda intégrée à l'API, essayons d'envoyer une demande. Comme il s'agit d'une requête GET, nous pouvons le faire à partir d'un navigateur Web. Utilisons donc l'URL de base unique fournie par AWS et ajoutez /drivers à l'URL. Et comme vous le verrez ici, le tableau JSON complet de toutes les informations sur le pilote est affiché. Passons maintenant à l'essai pour appeler ce service depuis Postman. Commençons une nouvelle collection dans Postman et nous l'appellerons AWS et ajouterons une nouvelle requête. Nous l'appellerons GET/drivers et collerons l'URL. Nous allons cliquer sur envoyer, et voici les pilotes au format JSON et un code d'état 200. L'outil de passerelle API dans AWS fournit également de nombreux services pour prendre en charge l'API, y compris les outils de limitation limiter le trafic entrant, métriques et journalisation à l'aide du produit CloudWatch où nous pouvons voir tous les détails de chaque demande entrante et potentiellement voir toutes les réponses qui ont été envoyées. Services similaires offerts par Microsoft Azure et Google Cloud Platform fonctionnent à peu près de la même manière et offrent également un ensemble riche d'intégrations avec d'autres services cloud. Merci d'avoir regardé. Restez à l'écoute pour la prochaine leçon où je vais vous montrer comment les opérations sont alignées sur les méthodes HTTP dans une API RESTful.

Débutant Fournisseur : Josh Guardino 3 leçons · 14m en Arabe, Allemand, Anglais, Espagnol, Français, Portugais, Chinese

Description du cours

Les API RESTful peuvent s’exécuter dans une grande variété de paramètres, mais le plus courant est devenu le cloud public. Ces leçons exploreront les différents produits API proposés par les principaux fournisseurs de services cloud et montreront comment une API simple peut être configurée et lancée à l’aide du produit AWS API Gateway.

Le module explore également l’alignement des méthodes et des points de terminaison REST avec les processus métier, existants et nouveaux. Étant donné que les services REST reposent sur des méthodes HTTP, il est important de comprendre comment les processus métier envoient et consomment des données, et comment leurs opérations sont mieux représentées dans REST.

Une autre considération de conception très importante est le défi posé par la nécessité de réparer et d’améliorer les services API existants. La mise à niveau ou l’application de correctifs aux services API sans examiner attentivement les conséquences peut être désastreuse; mais nous allons vous montrer comment utiliser le contrôle de version de l’API pour gérer ces problèmes de manière appropriée.

Ce que vous allez apprendre

Identifier les principaux fournisseurs de cloud public et les offres de services qui prennent en charge les API RESTful
Configurer et lancer une API simple à l'aide du produit AWS API Gateway
Aligner les méthodes et les terminaux REST sur les processus commerciaux existants et nouveaux
Expliquer comment les méthodes HTTP représentent des types spécifiques d'actions pour des processus existants ou nouveaux
Appliquer le versionnage d'API pour corriger et améliorer les services d'API existants sans causer de conflits

Points clés à retenir

Les API RESTful peuvent s'exécuter dans de nombreux environnements, mais le cloud public est devenu le plus courant.
Comme les services REST s'appuient sur les méthodes HTTP, il est essentiel de comprendre comment les processus commerciaux envoient et consomment les données pour représenter leurs opérations de type REST.
Mettre à niveau ou corriger des services d'API sans en considérer les conséquences peut s'avérer désastreux.
Le versionnage vous permet d'éviter les conflits et d'introduire des améliorations de manière responsable.

Foire aux questions

Que couvre ce cours ?

Il explore les produits d'API offerts par les principaux fournisseurs de services cloud, montre comment configurer et lancer une API simple avec l'AWS API Gateway, couvre l'alignement des méthodes et des terminaux REST avec les processus métier, et explique l'utilisation du versionnage d'API pour corriger et améliorer les services existants.

Vais-je apprendre à utiliser les outils d'un fournisseur de cloud spécifique ?

Oui. Les leçons montrent comment une API simple peut être configurée et lancée à l'aide du produit AWS API Gateway, et explorent les divers produits d'API proposés par les principaux fournisseurs de services cloud.

Comment le cours est-il structuré ?

Il est organisé en trois leçons : Considérations sur la conception d'API REST, Alignement des opérations avec les méthodes HTTP, et Maintenance des versions d'API.

Quelles compétences vais-je développer ?

Le cours permet de développer des compétences en conception d'API, en gestion d'API, en développement d'API REST et en utilisation de clients REST et d'API RESTful, y compris l'utilisation avancée de clients REST.