Cours accéléré sur les API REST

Leçon 1 • Style architectural REST

Couvre les six contraintes REST définies par Fielding et comment elles façonnent la conception d'API. Relie les principes architecturaux aux décisions de conception pratiques.

Leçon 2 • Principes fondamentaux du protocole HTTP

Explique HTTP comme couche de transport pour les API REST, 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. Autres styles d'API

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

Leçon 1 • Méthodes HTTP principales

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'action 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 de statut HTTP

Explique les cinq classes de codes de statut (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 • Principes de base de la modélisation des ressources

Enseigne comment identifier les ressources à partir d'entités du domaine et les représenter comme des noms dans les URL. Ancre la conception des points de terminaison dans une approche axée d'abord 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 lisibles et logiquement structurées.

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

Introduit une liste de contrôle structurée pour évaluer les conceptions de points de terminaison avant la mise en œuvre. Relie la qualité de la conception à l'expérience des développeurs en aval.

Leçon 4 • Conventions de nommage et normes

Établit des conventions cohérentes de casse, de délimiteur et de version pour les 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 la 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 de format entre le client et le serveur. Permet aux API de prendre en charge plusieurs formats sans perturber 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 de 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 l'autorisation déléguée pour les API destinées aux utilisateurs.

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

Introduit l'authentification vs. l'autorisation et les vecteurs de menace courants ciblant les API. Définit l'état d'esprit de sécurité requis pour tous les sujets de mise en œuvre ultérieurs.

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

Applique des 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 basé sur le moindre privilège au niveau de la ressource.

Leçon 4 • Authentification par clé API

Couvre la génération de clés API, la 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 performance et de convivialité causés par les réponses de collection non bornées. Motive le besoin de pagination avant d'introduire des stratégies de mise en œuvre.

Leçon 3 • Pagination par curseur

Introduit la pagination par curseur comme une alternative stable et performante à la pagination par décalage. Traite les scénarios de données en temps réel et de grands ensembles de données.

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

Enseigne les conventions de 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 code, message et détail. Des formes d'erreur cohérentes réduisent le temps de débogage des consommateurs.

Leçon 2 • Renvoi des erreurs de validation

Enseigne comment agréger et renvoyer plusieurs erreurs de validation dans une seule réponse. Améliore l'expérience développeur en faisant apparaître 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 gestion de versions

Explique les changements cassants vs. non cassants et l'impact sur les consommateurs d'une évolution sans versioning. Établit le business case pour une stratégie de gestion des versions.

Leçon 2 • Spécification OpenAPI

Introduit la spécification OpenAPI comme 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 gestion des versions

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

Leçon 4 • Maintenance et dépréciation des versions

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