Cours intensif API REST

Leçon 1 • Style architectural REST

Couvre les six contraintes REST définies par Fielding et leur influence sur la conception des API. Fait le lien entre les principes architecturaux et les décisions de conception pratiques.

Leçon 2 • Fondamentaux du protocole HTTP

Explique le rôle du protocole HTTP en tant que couche de transport pour les API REST, en couvrant les requêtes, les réponses et les en-têtes. Fournit les connaissances du protocole nécessaires pour tous les chapitres suivants.

Leçon 3 • REST vs. d'autres styles d'API

Compare REST à SOAP, GraphQL et gRPC selon des dimensions clés. Aide les apprenants à choisir le style approprié pour un cas d'utilisation donné.

Leçon 1 • Méthodes HTTP de base

Couvre GET, POST, PUT, PATCH et DELETE avec leur sémantique prévue et leurs propriétés de sécurité et d'idempotence. Forme le vocabulaire d'actions pour chaque point de terminaison REST.

Leçon 2 • Idempotence et sécurité

Définit l'idempotence et la sécurité comme des propriétés de méthode qui affectent la logique de nouvelle tentative et la mise en cache. Relie ces propriétés à un comportement fiable de l'API.

Leçon 3 • Classes de codes d'état HTTP

Explique les cinq classes de codes d'état (1xx à 5xx) et leur signification dans les réponses REST. Permet une interprétation précise de toute réponse d'API.

Leçon 1 • Bases de la modélisation des ressources

Enseigne comment identifier les ressources à partir d'entités du domaine et les représenter sous forme de noms dans les URL. Ancre la conception des points de terminaison dans une approche axée sur les ressources.

Leçon 2 • Structure et hiérarchie des URL

Couvre les segments de chemin, les ressources imbriquées et les paramètres de requête pour exprimer les relations et les filtres. Produit des URL faciles à lire et structurées de manière logique.

Leçon 3 • Processus de révision de la conception des points de terminaison

Présente une liste de vérification structurée pour évaluer les conceptions de points de terminaison avant la mise en œuvre. Relie la qualité de la conception à l'expérience du développeur en aval.

Leçon 4 • Conventions et normes de nommage

Établit des conventions cohérentes pour la casse, les délimiteurs et le versionnement des noms de points de terminaison. Garantit que les API sont prévisibles entre les équipes et les projets.

Leçon 1 • Conception du corps de réponse

Couvre les modèles d'enveloppe, la représentation des ressources et les structures de réponse d'erreur. Garantit que les consommateurs reçoivent des données cohérentes et exploitables.

Leçon 2 • Négociation de contenu

Explique les en-têtes Accept et Content-Type pour la négociation du format entre le client et le serveur. Permet aux API de soutenir plusieurs formats sans casser les consommateurs.

Leçon 3 • JSON comme format standard

Couvre la syntaxe JSON, les types de données et les règles de sérialisation en tant que format de charge utile REST dominant. Fournit la base du format de données pour tout travail de conception de charge utile.

Leçon 1 • Flux OAuth 2.0

Explique les quatre types d'octroi OAuth 2.0 et quand les appliquer. Permet aux apprenants de mettre en œuvre une autorisation déléguée pour les API destinées aux utilisateurs.

Leçon 2 • Fondamentaux de la sécurité des API

Présente l'authentification vs. l'autorisation et les vecteurs de menace courants ciblant les API. Établit l'état d'esprit de sécurité requis pour tous les sujets de mise en œuvre suivants.

Leçon 3 • Contrôle d'accès basé sur les rôles

Applique les règles d'autorisation aux points de terminaison à l'aide de rôles et de portées. Garantit que les API appliquent un accès au moindre privilège au niveau de la ressource.

Leçon 4 • Authentification par clé API

Couvre la génération de clés API, leur transmission via des en-têtes ou des paramètres de requête, et les stratégies de rotation. Fournit un mécanisme d'authentification simple adapté aux scénarios serveur à serveur.

Leçon 1 • Pagination par décalage et limite

Couvre le modèle de décalage-limite, ses conventions de paramètres de requête et ses limites à grande échelle. Fournit la base de pagination la plus utilisée.

Leçon 2 • Pourquoi la pagination est importante

Explique les problèmes de rendement et d'utilisabilité causés par les réponses de collection non limitées. Motive le besoin de pagination avant d'introduire des stratégies de mise en œuvre.

Leçon 3 • Pagination basée sur un curseur

Présente la pagination par curseur comme une alternative stable et performante à la pagination par décalage. Aborde les scénarios de données en temps réel et d'ensembles de données volumineux.

Leçon 4 • Tri et sélection de champs

Enseigne les conventions des paramètres de tri et les modèles d'ensembles de champs clairsemés pour réduire la taille de la charge utile. Complète la boîte à outils de récupération de données pour une consommation efficace de l'API.

Leçon 1 • Conception de la réponse d'erreur

Établit un schéma de réponse d'erreur standard comprenant les champs de code, de message et de détail. Des formes d'erreur cohérentes réduisent le temps de débogage pour les consommateurs.

Leçon 2 • Retour des erreurs de validation

Enseigne comment agréger et retourner plusieurs erreurs de validation dans une seule réponse. Améliore l'expérience du développeur en révélant tous les problèmes à la fois.

Leçon 3 • Stratégies de validation des entrées

Couvre la validation côté serveur des corps de requête, des paramètres de chemin et des paramètres de requête. Empêche les données invalides d'atteindre la logique métier ou la base de données.

Leçon 1 • Pourquoi les API ont besoin de versionnement

Explique les changements cassants vs. non cassants et l'impact sur les consommateurs d'une évolution sans versionnement. Établit le justificatif commercial d'une stratégie de versionnement.

Leçon 2 • Spécification OpenAPI

Présente la spécification OpenAPI comme le standard pour décrire les API REST dans un format lisible par machine. Relie la conception axée sur la spécification à la documentation et à la génération de code.

Leçon 3 • Stratégies de versionnement

Compare le versionnement par chemin d'URL, paramètre de requête et en-tête avec les compromis pour chacun. Permet un choix éclairé de l'approche de versionnement pour tout projet.

Leçon 4 • Maintien et obsolescence des versions

Fournit un processus pour communiquer les obsolescences, définir les dates de fin de vie et retirer les anciennes versions. Protège les consommateurs tout en permettant l'évolution de l'API.