Strapi permet de gérer des contenus et de les rendre accessibles à un site web, une application mobile ou un autre service, sans imposer de présentation prédéfinie. Cette formation de deux jours vous guide de la conception d’un projet à la création d’une API headless sur mesure. Vous alternerez explications, démonstrations et exercices pour construire une base solide et réutilisable.
Vous travaillerez sur un cas concret, par exemple une API de catalogue éditorial comprenant des articles, des auteurs et des catégories. Le parcours aborde également les bonnes pratiques de sécurité, de test et de préparation à la mise en ligne.
Module 1 — Comprendre Strapi et préparer son projet
Le principe d’un CMS headless
Vous découvrirez la différence entre un CMS traditionnel et un CMS headless. Avec Strapi, les contenus sont administrés séparément de leur affichage et peuvent être consommés par plusieurs interfaces. Nous examinerons le rôle de l’API, les échanges de données et la place de Node.js dans l’écosystème.
Installation et organisation
Vous prendrez en main l’environnement de travail, les commandes utiles et la structure d’un projet Strapi. Nous verrons comment lancer le serveur, accéder à l’interface d’administration et repérer les principaux éléments d’un projet. L’objectif est de savoir où intervenir sans modifier le code au hasard.
Exemple concret : une même API fournit les informations d’un article à un site vitrine et à une application mobile, qui choisissent chacun leur propre mise en page.
Exercice pratique : créer un projet de démonstration, démarrer Strapi et repérer les fichiers et espaces de travail essentiels.
Module 2 — Modéliser les contenus
Types de contenu, champs et relations
Vous apprendrez à traduire un besoin métier en structure de données claire. Nous créerons des types de contenu, des champs adaptés et des relations entre les éléments. Vous verrez quand utiliser un contenu répétable ou un contenu unique, et comment éviter les modèles trop complexes ou redondants.
Organiser la saisie éditoriale
Une API utile repose aussi sur une administration compréhensible. Vous configurerez les champs pour faciliter le travail des personnes qui publieront les contenus : titres explicites, champs obligatoires pertinents et informations bien regroupées. Nous aborderons les médias et les contenus réutilisables.
Exemple concret : pour un catalogue de ressources, un article peut être associé à un auteur, à plusieurs catégories et à une image de couverture.
Exercice pratique : concevoir et créer le modèle d’un catalogue éditorial, puis ajouter quelques éléments liés entre eux.
Module 3 — Construire et tester l’API
Accéder aux données
Vous découvrirez comment Strapi expose les contenus et comment consulter les données disponibles. Nous verrons les requêtes de lecture, les paramètres de filtrage, le tri, la pagination et la sélection des champs. Vous apprendrez à adapter les réponses aux besoins d’un consommateur sans récupérer plus de données que nécessaire.
Vérifier les réponses
À l’aide d’outils de test d’API, vous enverrez des requêtes et analyserez les réponses obtenues. Nous examinerons les erreurs courantes, comme un contenu non publié, un mauvais identifiant ou un paramètre incorrect. Vous apprendrez à vérifier les résultats avant de connecter une interface.
Exemple concret : afficher uniquement les ressources d’une catégorie donnée, dans l’ordre de publication, avec un nombre limité de résultats par page.
Exercice pratique : préparer plusieurs requêtes pour rechercher, trier et paginer les éléments du catalogue créé précédemment.
Module 4 — Personnaliser les règles et sécuriser les accès
Permissions et rôles
Vous verrez comment contrôler les actions accessibles aux visiteurs et aux utilisateurs authentifiés. Nous distinguerons les permissions de lecture et d’écriture, puis vérifierons les accès sur des routes et contenus représentatifs. L’objectif est de ne rendre public que ce qui doit l’être.
Adapter le comportement avec Node.js
Vous découvrirez les points d’extension de Strapi et les principes de personnalisation côté serveur. Nous verrons comment aborder une règle métier spécifique, organiser les changements et garder un code compréhensible. Les exemples resteront progressifs afin de mieux comprendre le lien entre la configuration de Strapi et Node.js.
Exemple concret : rendre un catalogue consultable publiquement tout en réservant la création et la modification des contenus aux personnes autorisées.
Exercice pratique : définir les permissions de différents profils, tester les accès et corriger une configuration trop ouverte.
Module 5 — Préparer le projet pour la suite
Configuration et bonnes pratiques
Vous passerez en revue les paramètres à vérifier avant de partager un projet : variables de configuration, données sensibles, médias et cohérence entre environnements. Nous parlerons également de sauvegarde, de gestion des évolutions du modèle et de documentation minimale pour faciliter la reprise par une autre personne.
Faire évoluer une API sans perdre le fil
Vous apprendrez à examiner les conséquences d’un changement de contenu ou de permission sur les usages existants. Une API est consommée par d’autres applications : il est donc important de tester les modifications et de communiquer les changements utiles. Nous établirons une checklist de vérification adaptée à un projet de taille courante.
Exemple concret : ajouter une nouvelle information à une ressource tout en vérifiant que les requêtes déjà utilisées par le site continuent de fonctionner.
Exercice pratique : enrichir le modèle, tester les principales routes et rédiger une courte documentation de prise en main pour l’équipe.
À retenir
Vous repartirez avec une méthode pour concevoir des contenus structurés, exposer une API Strapi et contrôler les accès. Les exercices vous permettront de relier les réglages du CMS aux besoins réels d’un projet web.
Pour aller plus loin
Après la formation, vous pourrez appliquer cette démarche à un projet existant, connecter l’API à une interface web ou mobile, et approfondir les personnalisations côté serveur avec Node.js. Les besoins propres à votre organisation pourront ensuite guider les choix de modèle, de permissions et de déploiement.
