Cours de développement d'API pour débutants

Leçon 1 • Comment fonctionne le Web

Explique le HTTP, le DNS et l’interaction navigateur-serveur comme infrastructure sur laquelle les API s’exécutent. Relie les fondamentaux du Web aux cycles requête-réponse des API.

Leçon 2 • Types d’API

Passe en revue les API REST, SOAP, GraphQL et WebSocket selon leur objectif et leur structure. Aide les étudiants à choisir le style d’API approprié pour un scénario donné.

Leçon 3 • Lecture de la documentation d’API

Enseigne comment naviguer et interpréter la documentation officielle d’une API, y compris les points de terminaison, les paramètres et les notes d’authentification. Prépare les étudiants à utiliser toute API publique de manière autonome.

Leçon 1 • Structure d’une réponse HTTP

Explique les codes d’état, les en-têtes de réponse et les corps de charges utiles renvoyés par les serveurs. Équipe les étudiants pour diagnostiquer correctement les réponses d’API.

Leçon 2 • Test des requêtes avec des clients d’API

Présente des outils de test d’API basés sur une interface graphique pour envoyer et inspecter des requêtes en direct sans écrire de code. Développe la confiance pratique avant la programmation.

Leçon 3 • Anatomie d’une requête HTTP

Décompose la ligne de requête, les en-têtes et les composants du corps avec des exemples concrets. Les étudiants acquièrent la capacité de construire des requêtes valides manuellement.

Leçon 1 • Validation et linting des données

Enseigne la validation de schémas et les outils de linting pour détecter les charges utiles mal formées avant qu’elles n’atteignent une API. Renforce les habitudes de qualité des données essentielles pour le travail en production.

Leçon 2 • Travailler avec JSON dans le code

Démontre la sérialisation et la désérialisation de JSON à l’aide d’un langage de script. Relie les connaissances sur les formats de données aux tâches pratiques d’intégration d’API.

Leçon 3 • Notions de base sur XML et comparaison avec JSON

Présente la structure XML, les éléments, les attributs et les espaces de noms pour les contextes d’API hérités. Les étudiants comprennent quand XML est nécessaire et en quoi il diffère de JSON.

Leçon 1 • Gestion des données de requête

Couvre la lecture des chaînes de requête, des paramètres de chemin et des corps de requête dans les fonctions de gestionnaire. Permet aux étudiants de construire des points de terminaison dynamiques et axés sur les données.

Leçon 2 • Définition des routes et des points de terminaison

Enseigne comment déclarer des routes URL et les mapper à des fonctions de gestionnaire dans un cadre applicatif Web. Les étudiants créent le squelette d’une ressource REST.

Leçon 3 • Renvoi de réponses HTTP appropriées

Applique les codes d’état, les en-têtes et les messages d’erreur corrects dans chaque réponse de point de terminaison. Aligne l’API de l’étudiant sur les conventions REST professionnelles.

Leçon 4 • Configuration de l’environnement de développement

Guide l’installation d’un environnement d’exécution, d’un gestionnaire de paquets et d’un cadre applicatif Web nécessaires pour construire l’API. Élimine les frictions de configuration pour que les étudiants se concentrent immédiatement sur la logique de l’API.

Leçon 1 • Authentification vs autorisation

Clarifie la distinction conceptuelle entre la vérification de l’identité et l’octroi d’autorisations. Établit le modèle mental requis avant d’implémenter tout mécanisme de sécurité.

Leçon 2 • Notions fondamentales sur OAuth 2.0

Présente les types d’octroi OAuth 2.0 et le flux du code d’autorisation pour l’accès par des tiers. Les étudiants comprennent comment fonctionne l’autorisation déléguée dans les API en production.

Leçon 3 • Sécurisation des points de terminaison avec un intergiciel

Démontre l’écriture d’un intergiciel d’authentification réutilisable qui protège les routes sécurisées. Relie les concepts de sécurité à des modèles de code pratiques et maintenables.

Leçon 4 • Authentification par jeton avec JWT

Explique la structure JWT, la signature et la vérification pour une authentification sans état. Les étudiants émettent et valident des jetons dans leur API à l’aide d’une bibliothèque de signature.

Leçon 1 • Principes d’une bonne gestion des erreurs

Établit pourquoi des réponses d’erreur cohérentes et informatives améliorent l’expérience du développeur. Cadre la gestion des erreurs comme une discipline de conception, et non comme une réflexion a posteriori.

Leçon 2 • Techniques de validation des entrées

Couvre la validation des types de données, des champs obligatoires, des formats et des plages de valeurs avant le traitement. Les étudiants ajoutent des couches de validation à chaque point de terminaison de leur API.

Leçon 3 • Gestion des erreurs de base de données et externes

Aborde les erreurs provenant des requêtes de base de données et des appels d’API tiers dans la logique du gestionnaire. Les étudiants enveloppent les appels externes avec des stratégies appropriées de try-catch et de repli.

Leçon 1 • Migrations de base de données

Enseigne les modifications de schéma contrôlées par version à l’aide de scripts de migration. Les étudiants appliquent et annulent des migrations pour gérer l’évolution de la base de données en toute sécurité.

Leçon 2 • Écriture de requêtes SQL dans les gestionnaires d’API

Remplace la logique en mémoire par des requêtes SQL paramétrées dans les gestionnaires CRUD. Les étudiants exécutent SELECT, INSERT, UPDATE et DELETE sur une base de données réelle.

Leçon 3 • Utilisation d’un ORM pour l’accès à la base de données

Présente un mappeur objet-relationnel pour abstraire le SQL brut en opérations basées sur des modèles. Les étudiants comparent les approches ORM et SQL brut pour différents scénarios.

Leçon 4 • Notions fondamentales sur les bases de données relationnelles

Couvre les tables, les lignes, les colonnes, les clés primaires et les clés étrangères comme modèle de données pour l’API. Fournit le vocabulaire de conception de schémas nécessaire pour tout travail de base de données à venir.

Leçon 1 • Surveillance et observabilité de base

Présente la journalisation, les points de terminaison de vérification de l’état et la surveillance de la disponibilité pour une API déployée. Les étudiants implémentent l’observabilité minimale nécessaire pour détecter et diagnostiquer les problèmes.

Leçon 2 • Déploiement de l’API dans le nuage

Guide la conteneurisation de l’API et son déploiement sur une plateforme infonuagique avec des variables d’environnement. Les étudiants accèdent à leur API en direct via une URL publique.

Leçon 3 • Tests d’intégration des points de terminaison d’API

Démontre des tests de bout en bout qui envoient de vraies requêtes HTTP à un serveur de test en cours d’exécution. Les étudiants valident des cycles complets requête-réponse, y compris l’interaction avec la base de données.

Leçon 4 • Rédaction de documentation d’API avec OpenAPI

Enseigne le format de spécification OpenAPI pour documenter les points de terminaison, les paramètres et les schémas. Les étudiants génèrent une documentation interactive à partir de leur code d’API.