Cours de programmation API

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

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

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

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

Leçon 3 • Fondamentaux 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 de base

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

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

Mappe 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 de la charge utile, 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. Jette les bases structurelles 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 les grands ensembles de données. Les étudiants mettent en œuvre des stratégies de pagination qui équilibrent performance 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 • Échafaudage du projet et routage

Configure une application serveur, définit les routes et les mappe aux fonctions de gestion. É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 • Implémentation 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 soutenus par une base de données.

Leçon 1 • Cadre 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 étudiants intègrent un flux OAuth tiers dans leur API.

Leçon 2 • Jetons Web JSON (JWT)

Explique la structure, la signature et la vérification des JWT pour l'authentification sans état. Les étudiants é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 prouver son identité et accorder des autorisations. Encadre le modèle de sécurité que les étudiants mettront en œuvre dans les sections suivantes.

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

Implémente des schémas simples basés sur les identifiants adaptés à une utilisation serveur à serveur. Les étudiants comprennent leurs limites avant de passer aux méthodes basées sur les jetons.

Leçon 1 • Conception de schémas 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 changements d'API et journaux des modifications

Établit des pratiques pour communiquer les changements majeurs et mineurs aux consommateurs de l'API. Connecte la stratégie de versionnage du chapitre 2 aux flux de travail de documentation.

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

Utilise des outils pour transformer les spécifications OpenAPI en documentation navigable et testable. Les étudiants 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 avec l'écriture de spécifications avant le codage. Les étudiants é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 de base 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 véritables requêtes HTTP à un serveur de test en cours d'exécution et vérifie les réponses. Valide que les couches de routage, d'intergiciel et de base de données fonctionnent ensemble correctement.

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

Présente la pyramide de test et mappe les types de test 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 défectueux 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 identifiants, 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 ou les journaux.

Leçon 3 • Limitation du débit et throttling

Implémente des limites de taux de requêtes pour protéger les API contre les abus et les attaques par déni de service. Les étudiants configurent des limites au niveau des points de terminaison et des clients.

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

Assure un transport chiffré 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 structurés, des métriques et des traces distribuées. Permet un diagnostic rapide des problèmes de production et une planification éclairée de la capacité.

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

Mesure des temps de réponse de l'API et identification des requêtes lentes, des E/S bloquantes et du 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 de longue durée à 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

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