Back-end & frameworks
Concevoir et sécuriser une API REST
Les principes REST, la conception de ressources, la documentation OpenAPI et la sécurité des API.
- Durée
- 14 h · 2 jours
- Niveau
- Intermédiaire
- Format
- Présentiel · Distanciel · Mixte
- Effectif max.
- 12 participants
Présentation
Ce programme apprend à concevoir des API REST claires et durables : principes de l’architecture REST, modélisation des ressources, conventions, pagination et filtres, documentation avec OpenAPI, authentification et sécurité. Les participants conçoivent une API complète et la testent avec les outils usuels.
À qui s’adresse ce programme
- Développeurs back-end et full stack
- Architectes et leads techniques
- Développeurs mobiles qui consomment des API
Prérequis
- Bases dans un langage de programmation
- Notions de HTTP et de JSON
Objectifs pédagogiques
- Expliquer les contraintes de l’architecture REST
- Concevoir des ressources, des verbes et des codes de réponse cohérents
- Gérer pagination, tri, filtres et versionnement
- Documenter une API avec OpenAPI et Swagger
- Mettre en place authentification et autorisations (JWT, OAuth, OpenID)
- Connaître les risques de sécurité des API
Programme détaillé
4 modules · 14 h · 2 jours
Jour 1
Principes de REST
50 % théorie · 50 % pratique
- Origines et contraintes de l’architecture REST
- Ressources, représentations et URI
- Verbes HTTP et idempotence
- Codes de statut et en-têtes
- REST, RPC et GraphQL : comparaison
Conception de services RESTful
30 % théorie · 70 % pratique
- Modéliser les ressources d’un domaine
- Conventions de nommage
- Sous-ressources et relations
- Gestion des erreurs : format de réponse
- Versionnement
🛠 Ateliers pratiques
Conception d’une API1,5 h
Concevoir l’API d’une application de réservation.
✅ Livrable : Un schéma d’API
Jour 2
Fonctionnalités courantes et documentation
30 % théorie · 70 % pratique
- CRUD, pagination, tri et filtres
- Mises à jour partielles
- Description avec OpenAPI
- Génération de documentation interactive
- Formats hypermédias : panorama
🛠 Ateliers pratiques
Documenter l’API2 h
Écrire la spécification OpenAPI de l’API conçue.
✅ Livrable : Une spécification OpenAPI
Authentification et sécurité
30 % théorie · 70 % pratique
- Authentification par jeton, JWT
- OAuth 2 et OpenID Connect : principes
- Autorisations et portées
- Menaces classiques : OWASP API, CORS, CSRF
- Limitation de débit et journalisation
🛠 Ateliers pratiques
Revue de sécurité1,5 h
Auditer une API de démonstration et proposer les correctifs.
✅ Livrable : Un rapport de sécurité
Outils et technologies
PostmanVisual Studio Code
Méthodes pédagogiques
- Alternance d’exposés courts et de travaux pratiques
- Démonstrations en direct par le formateur
- Projet fil rouge construit au fil des modules
- Corrections collectives et échanges sur les bonnes pratiques
Évaluation
- Exercices pratiques corrigés à chaque module
- Mini-projet réalisé en fin de formation
- Quiz de validation des acquis
Matériel requis
- Un ordinateur avec une connexion internet
- Un outil de test d’API (Postman ou équivalent)
- Un éditeur de code
Ressources fournies
- Support de cours et dépôt d’exercices corrigés
Débouchés
- Un contrat d’API documenté
- Une grille de conception réutilisable
- Les réflexes de sécurité des API