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 • 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 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é/idempotence. Forme le vocabulaire des 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 d'API fiable.

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

Apprend à identifier les ressources à partir des entités du domaine et à les représenter sous forme de noms dans les URL. Ancre la conception des points de terminaison dans un état d'esprit axé 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 développeur en aval.

Leçon 4 • Conventions et normes de nommage

É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 dominant pour REST. 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

Introduit 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 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, 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 décalage-limite, ses conventions de paramètres de requête et ses limites à grande échelle. Fournit la référence de pagination la plus largement 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 limitées. Justifie le besoin de pagination avant d'introduire les stratégies de mise en œuvre.

Leçon 3 • Pagination basée sur un 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

Apprend les conventions de syntaxe des paramètres de tri et les modèles de jeux de champs réduits pour diminuer 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 incluant les champs code, message et détails. Des formes d'erreur cohérentes réduisent le temps de débogage du consommateur.

Leçon 2 • Renvoi des erreurs de validation

Apprend à 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 version

Explique les changements cassants vs. non cassants et l'impact sur les consommateurs d'une évolution sans version. Établit le cas d'affaires pour une stratégie de gestion de version.

Leçon 2 • Spécification OpenAPI

Introduit la spécification OpenAPI comme norme pour décrire les API REST dans un format lisible par machine. Relie la conception par spécification à la documentation et à la génération de code.

Leçon 3 • Stratégies de gestion de version

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

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

Fournit un processus pour communiquer les dépréciations, 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.