Formation développement d'API pour débutants

Leçon 1 • Comment fonctionne le Web

Explique HTTP, le DNS et l'interaction navigateur-serveur en tant qu'infrastructure sur laquelle les API fonctionnent. 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 adapté à un scénario donné.

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

Apprend à naviguer et à interpréter la documentation officielle des 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 de la réponse HTTP

Explique les codes d'état, les en-têtes de réponse et les charges utiles du corps renvoyées par les serveurs. Équipe les étudiants pour diagnostiquer avec précision les réponses d'API.

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

Présente les outils de test d'API basés sur une interface graphique pour envoyer et inspecter des requêtes en direct sans écrire de code. Renforce la confiance pratique avant de commencer à coder.

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éma et les outils de linting pour détecter les charges utiles malformé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 la connaissance du format de données aux tâches pratiques d'intégration d'API.

Leçon 3 • Bases de 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 requis 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 endpoints dynamiques et pilotés par les données.

Leçon 2 • Définition des routes et des endpoints

Enseigne comment déclarer des routes URL et les mapper à des fonctions de gestionnaire dans un framework web. Les étudiants créent le squelette d'une ressource RESTful.

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

Impose des codes d'état, des en-têtes et des messages d'erreur corrects dans chaque réponse d'endpoint. Aligne l'API de l'étudiant sur les conventions REST professionnelles.

Leçon 4 • Mise en place de l'environnement de développement

Guide l'installation d'un environnement d'exécution, d'un gestionnaire de paquets et d'un framework web nécessaires à la construction de l'API. Supprime 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 un mécanisme de sécurité.

Leçon 2 • Fondamentaux d'OAuth 2.0

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

Leçon 3 • Sécurisation des endpoints avec un intergiciel

Démontre l'écriture d'un intergiciel d'authentification réutilisable qui protège les routes protégé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, la signature et la vérification de JWT pour l'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 développeur. Considère la gestion des erreurs comme une discipline de conception, et non comme une réflexion après coup.

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 endpoint de leur API.

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

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

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

Enseigne les modifications de schéma contrôlées par le versioning à 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 • Fondamentaux de la base de données relationnelle

Couvre les tables, les lignes, les colonnes, les clés primaires et les clés étrangères en tant que modèle de données pour l'API. Fournit le vocabulaire de conception de schéma nécessaire pour tout le 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 cloud

Guide la conteneurisation de l'API et son déploiement sur une plateforme cloud 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 endpoints, les paramètres et les schémas. Les étudiants génèrent une documentation interactive à partir de leur code d'API.