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.

Demander ce programme
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 REST3,5 h
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 RESTful3,5 h🛠 1 atelier
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 documentation3,5 h🛠 1 atelier
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é3,5 h🛠 1 atelier
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