Cours API REST

Leçon 1 • URLs, URIs et Nommage des Ressources

Explique la structure des URI et comment les ressources sont adressées dans REST. Un nommage correct impacte directement la facilité d'utilisation et la découvrabilité de l'API.

Leçon 2 • Essentiels du Protocole HTTP

Couvre le cycle requête-réponse HTTP, les en-têtes et les codes d'état. Fournit la base protocolaire sur laquelle repose toute API REST.

Leçon 3 • Qu'est-ce qu'une API REST

Définit REST comme un style architectural et le contraste avec RPC et SOAP. Établit le vocabulaire utilisé tout au long du cours.

Leçon 4 • Six Contraintes Architecturales REST

Examine chaque contrainte de Fielding et son implication pratique. La compréhension des contraintes guide les décisions de conception d'API conformes.

Leçon 1 • Stratégies de Gestion de Versions d'API

Compare les approches de versionnement par URI, en-tête et type de média. Choisir la bonne stratégie évite les changements cassants pour les clients existants.

Leçon 2 • Conception des Corps de Requête et de Réponse

Définit la structure du corps, les conventions de nommage des champs et d'enveloppe. Des corps bien conçus réduisent les erreurs d'intégration pour les consommateurs.

Leçon 3 • Conception de Sous-Ressources et Relations

Modélise les relations entre les ressources en utilisant des approches imbriquées et liées. Choisir le bon motif affecte la performance et la clarté.

Leçon 4 • Fondamentaux de la Modélisation des Ressources

Identifie les entités du domaine et les mappe aux ressources REST. Une modélisation correcte évite la prolifération et l'incohérence des points de terminaison.

Leçon 1 • Structure et Syntaxe JSON

Passe en revue les types de données JSON, l'imbrication et les pièges courants. JSON est le format de corps dominant dans REST et doit être manipulé avec précision.

Leçon 2 • Négociation de Contenu

Explique les en-têtes Accept et Content-Type pour la négociation de format. Permet aux API de servir plusieurs formats à partir d'un seul point de terminaison.

Leçon 3 • Gestion des Données Binaires et Fichiers

Couvre les téléversements multipart, l'encodage Base64 et les motifs de téléchargement de fichiers. La gestion des fichiers binaires est essentielle pour les API de médias et de documents.

Leçon 4 • Définition et Validation de Schéma

Utilise JSON Schema pour définir et valider les corps de requête et de réponse. La validation de schéma détecte les erreurs avant qu'elles n'atteignent la logique métier.

Leçon 1 • Flux OAuth 2.0

Fait correspondre les flux code d'autorisation, informations d'identification client et implicite aux cas d'utilisation. OAuth 2.0 est la norme industrielle pour l'accès délégué.

Leçon 2 • Clés d'API et Authentification de Base

Implémente des schémas d'identification simples et explique leurs limitations. Fournit une base de référence avant d'introduire les approches basées sur des jetons.

Leçon 3 • Authentification vs Autorisation

Distingue la vérification d'identité de l'application des permissions. La clarté sur ces concepts évite les erreurs de conception de sécurité courantes.

Leçon 4 • Contrôle d'Accès Basé sur les Rôles

Applique les permissions au niveau du point de terminaison et de la ressource en utilisant des rôles. RBAC garantit que les utilisateurs accèdent uniquement aux données qu'ils sont autorisés à voir.

Leçon 1 • Motifs d'Erreurs de Validation

Gère les échecs de validation d'entrée avec un retour d'information précis et exploitable. Les erreurs de validation sont le type d'erreur le plus fréquent dans les API REST.

Leçon 2 • Maîtrise des Codes d'État HTTP

Fait correspondre chaque classe de code d'état majeure aux scénarios d'utilisation corrects. Des codes d'état précis sont le premier signal que les consommateurs utilisent pour traiter les réponses.

Leçon 3 • Standard Problem Details

Applique le format problem details défini par la RFC pour les erreurs lisibles par machine. L'adoption d'un format standard améliore l'interopérabilité entre équipes.

Leçon 4 • Conception de Réponse d'Erreur Structurée

Définit un schéma de corps d'erreur cohérent avec les champs code, message et détail. Les erreurs structurées réduisent le temps de débogage pour les consommateurs de l'API.

Leçon 1 • Pourquoi la Documentation d'API est Importante

Établit la documentation comme un livrable produit, et non une réflexion après coup. Une bonne documentation réduit la charge de support et accélère l'intégration des consommateurs.

Leçon 2 • Documentation des Points de Terminaison et des Schémas

Rédige les descriptions d'opérations, les paramètres, les corps de requête et les schémas de réponse. Une documentation complète des points de terminaison permet une génération précise du code client.

Leçon 3 • Fondamentaux de la Spécification OpenAPI

Présente la structure OpenAPI : info, paths, components et servers. La spécification est la source unique de vérité pour le contrat de l'API.

Leçon 4 • Publication et Maintenance de la Documentation

Génère une documentation interactive avec Swagger UI et Redoc, et automatise les mises à jour. La publication automatisée maintient la documentation synchronisée avec la base de code.

Leçon 1 • Limitation de Débit et Écrêtage

Protège l'infrastructure API avec des limites de débit et communique ces limites aux clients. La limitation de débit prévient les abus et assure une répartition équitable des ressources.

Leçon 2 • Compression et Optimisation du Corps

Applique la compression gzip et Brotli et élimine les données de corps inutiles. La compression réduit significativement les coûts de bande passante pour les API à fort trafic.

Leçon 3 • Motifs de Pagination

Implémente la pagination par offset, curseur et keyset pour les grandes collections. Choisir le bon motif affecte la performance et les garanties de cohérence.

Leçon 4 • Filtrage, Tri et Sélection de Champs

Ajoute des contrôles par paramètres de requête pour le filtrage, l'ordonnancement et les ensembles de champs réduits. Ces fonctionnalités réduisent la taille du corps et le transfert de données inutile.

Leçon 1 • Sécurité du Transport et HTTPS

Applique TLS, configure HSTS et valide les certificats. Toutes les API REST de production doivent chiffrer les données en transit sans exception.

Leçon 2 • Stratégies de Test d'API

Couvre les tests unitaires, d'intégration et de contrat pour les points de terminaison REST. Une stratégie de test en couches détecte les défauts au coût le plus bas possible.

Leçon 3 • Surveillance, Journalisation et Observabilité

Instrumente les API avec des journaux structurés, des métriques et des traces distribuées. L'observabilité permet un diagnostic rapide des incidents de production.

Leçon 4 • Vulnérabilités de Sécurité dans les API REST

Identifie les risques d'injection, d'authentification cassée et d'exposition excessive de données. La compréhension des vecteurs d'attaque est un prérequis à une atténuation efficace.