Cours de développement d'API

Leçon 1 • Formats de données pour les API

Présente JSON, XML et autres formats de charge utile courants. Les apprenants apprennent à lire, écrire et valider des données structurées échangées par les API.

Leçon 2 • Configuration d'un environnement de développement

Guide les apprenants dans l'installation des outils nécessaires pour construire et tester des API localement. Assure un espace de travail cohérent et fonctionnel avant de commencer le codage.

Leçon 3 • Principes essentiels du protocole HTTP

Couvre les méthodes HTTP, les codes d'état, les en-têtes et le cycle requête-réponse. Fournit les connaissances de la couche de transport nécessaires pour tous les chapitres suivants.

Leçon 4 • Styles d'architecture d'API fondamentaux

Compare les paradigmes REST, SOAP, GraphQL et RPC au niveau conceptuel. Aide les apprenants à choisir le style approprié pour un problème donné.

Leçon 1 • Méthodes HTTP et correspondance CRUD

Fait correspondre les opérations de création, lecture, mise à jour et suppression aux méthodes HTTP appropriées. Renforce la sémantique correcte des méthodes et les règles d'idempotence.

Leçon 2 • Conception des requêtes et des réponses

Couvre la structure des charges utiles, la sélection des codes d'état et l'utilisation des en-têtes pour les requêtes et les réponses. Garantit que les API communiquent clairement leur intention aux consommateurs.

Leçon 3 • Modélisation des ressources et conception d'URL

Explique comment identifier les ressources, les nommer correctement et les mapper aux URL. Pose la base structurelle d'une surface d'API cohérente.

Leçon 4 • Filtrage, tri et pagination

Présente les modèles de paramètres de requête pour naviguer dans de grands ensembles de données. Les apprenants mettent en œuvre des stratégies de pagination qui équilibrent performances et convivialité.

Leçon 1 • Tests manuels avec des clients API

Utilise des outils clients API pour envoyer des requêtes et inspecter les réponses pour chaque point de terminaison. Instaure l'habitude de vérifier le comportement avant d'écrire des tests automatisés.

Leçon 2 • Structure du projet et routage

Configure une application serveur, définit des routes et les mappe à des fonctions de gestionnaire. Établit le squelette structurel du projet d'API.

Leçon 3 • Validation des entrées et gestion des erreurs

Ajoute une logique de validation et des réponses d'erreur structurées à chaque point de terminaison. Empêche les mauvaises données d'entrer dans le système et communique clairement les échecs.

Leçon 4 • Mise en œuvre des points de terminaison CRUD

Construit des gestionnaires de création, lecture, mise à jour et suppression avec une logique réelle. Connecte les opérations HTTP à des magasins de données en mémoire ou basés sur une base de données.

Leçon 1 • Framework d'autorisation OAuth 2.0

Présente les types d'octroi OAuth 2.0 et les rôles du serveur d'autorisation, du serveur de ressources et du client. Les apprenants intègrent un flux OAuth tiers dans leur API.

Leçon 2 • Jetons Web JSON (JWT)

Explique la structure JWT, la signature et la vérification pour l'authentification sans état. Les apprenants émettent des jetons lors de la connexion et les valident sur les routes protégées.

Leçon 3 • Concepts d'authentification vs. d'autorisation

Clarifie la distinction entre la preuve d'identité et l'octroi d'autorisations. Encadre le modèle de sécurité que les apprenants mettront en œuvre dans les sections suivantes.

Leçon 4 • Clés API et authentification de base

Met en œuvre des schémas simples basés sur des informations d'identification adaptés à une utilisation serveur à serveur. Les apprenants comprennent leurs limites avant de passer aux méthodes basées sur des jetons.

Leçon 1 • Conception de schéma avec JSON Schema

Couvre la syntaxe JSON Schema pour définir les modèles de données utilisés dans les spécifications OpenAPI. Permet une validation et une documentation précises de chaque champ de charge utile.

Leçon 2 • Gestion des modifications d'API et journaux des modifications

Établit des pratiques pour communiquer les modifications cassantes et non cassantes aux consommateurs de l'API. Connecte la stratégie de versionnement du chapitre 2 aux flux de documentation.

Leçon 3 • Génération de documentation d'API interactive

Utilise des outils pour rendre les spécifications OpenAPI sous forme de documentation navigable et interactive. Les apprenants publient une documentation que les développeurs peuvent utiliser pour explorer et tester l'API.

Leçon 4 • Flux de travail Code d'abord vs. Conception d'abord

Compare la génération de spécifications à partir d'annotations de code par rapport à l'écriture de spécifications avant le codage. Les apprenants évaluent quel flux de travail correspond au processus de développement de leur équipe.

Leçon 1 • Tests unitaires de la logique métier

Isole et teste les fonctions individuelles, les validateurs et les modules de service. Garantit que la logique fondamentale est correcte indépendamment des couches HTTP ou base de données.

Leçon 2 • Tests d'intégration des points de terminaison d'API

Envoi de vraies requêtes HTTP à un serveur de test en cours d'exécution et émet des assertions sur les réponses. Valide que les couches de routage, d'intergiciel et de base de données fonctionnent correctement ensemble.

Leçon 3 • Stratégie de test et pyramide

Présente la pyramide de test et mappe les types de tests aux couches d'API. Fournit un cadre pour décider du nombre de tests de chaque type à écrire.

Leçon 4 • Tests automatisés dans les pipelines CI

Configure un pipeline d'intégration continue pour exécuter la suite de tests complète à chaque commit. Garantit que les barrières de qualité empêchent le code cassé d'atteindre la production.

Leçon 1 • Assainissement des entrées et prévention des injections

Couvre les techniques pour neutraliser les attaques par injection ciblant les interpréteurs SQL, NoSQL et de commandes. S'appuie sur les compétences de validation du chapitre 3 avec un accent sur la sécurité.

Leçon 2 • Gestion des secrets et configuration sécurisée

Établit des pratiques pour stocker les informations d'identification, les clés et les valeurs de configuration en dehors du code source. Empêche l'exposition accidentelle de données sensibles dans les dépôts de code ou les journaux système.

Leçon 3 • Limitation de débit et régulation

Met en œuvre des limites de débit de requêtes pour protéger les API contre les abus et les attaques par déni de service. Les apprenants configurent des limites au niveau du point de terminaison et du client.

Leçon 4 • Sécurité du transport et HTTPS

Applique un transport crypté pour tout le trafic API et configure des paramètres TLS sécurisés. Empêche l'écoute clandestine et les attaques de l'homme du milieu sur les communications API.

Leçon 1 • Observabilité : journalisation, métriques et traçage

Instrumente l'API avec des journaux système structurés, des métriques et des traces distribuées. Permet un diagnostic rapide des problèmes de production et une planification éclairée des capacités.

Leçon 2 • Profilage des performances et analyse des goulots d'étranglement

Mesure les temps de réponse de l'API et identifie les requêtes lentes, les E/S bloquantes et le code inefficace. Établit une base de référence avant d'appliquer les optimisations.

Leçon 3 • Traitement asynchrone et files d'attente

Délègue les tâches longues à des travailleurs en arrière-plan via des files d'attente de messages. Améliore la réactivité de l'API en découplant la gestion des requêtes du traitement lourd.

Leçon 4 • Conteneurisation et déploiement

Empaquète l'API dans une image de conteneur logiciel et la déploie dans un environnement cloud ou sur site. Garantit des déploiements cohérents et reproductibles dans tous les environnements.