Skip to content
Learni
Voir tous les tutoriels
Backend

Comment configurer Strapi pour une API REST en 2026

12 minBEGINNER
API RESTCMS HeadlessStrapi
Read in English

Introduction

Strapi est un CMS headless open source qui permet de créer rapidement des APIs REST ou GraphQL. En 2026, il reste l'outil de référence pour les développeurs souhaitant séparer le backend du frontend. Ce tutoriel vous apprend à installer Strapi, créer un type de contenu et exposer des endpoints REST sécurisés. Vous découvrirez comment Strapi génère automatiquement les routes CRUD tout en offrant un panneau d'administration intuitif. Idéal pour les projets modernes nécessitant une gestion de contenu flexible.

Prérequis

  • Node.js 20 ou supérieur
  • npm ou yarn
  • Connaissances basiques de JavaScript
  • Un éditeur de code (VS Code recommandé)

Installation du projet Strapi

terminal
npx create-strapi-app@latest mon-api --quickstart

Cette commande crée un projet Strapi complet avec SQLite par défaut. Le flag --quickstart lance automatiquement le serveur après installation.

Lancement du serveur de développement

terminal
cd mon-api
npm run develop

Le serveur démarre sur http://localhost:1337. L'admin est accessible à /admin pour créer votre premier compte utilisateur.

Création du type de contenu Article

src/api/article/content-types/article/schema.json
{
  "kind": "collectionType",
  "collectionName": "articles",
  "info": {
    "singularName": "article",
    "pluralName": "articles",
    "displayName": "Article"
  },
  "options": {
    "draftAndPublish": true
  },
  "attributes": {
    "title": {
      "type": "string",
      "required": true
    },
    "content": {
      "type": "richtext"
    }
  }
}

Ce fichier JSON définit le modèle Article avec un titre obligatoire et un contenu riche. Redémarrez le serveur pour appliquer les changements.

Configuration des permissions API

src/api/article/routes/article.js
'use strict';

module.exports = {
  routes: [
    {
      method: 'GET',
      path: '/articles',
      handler: 'article.find',
      config: { policies: [] }
    }
  ]
};

Ce fichier active explicitement la route GET /api/articles. Strapi génère automatiquement les autres méthodes CRUD.

Test de l'API REST

terminal
curl http://localhost:1337/api/articles

Cette commande vérifie que l'endpoint REST renvoie bien les articles. Ajoutez des données via l'admin avant de tester.

Bonnes pratiques

  • Toujours activer draftAndPublish pour les contenus
  • Protéger les routes avec des policies ou des rôles
  • Utiliser des variables d'environnement pour les secrets
  • Versionner les fichiers de configuration
  • Tester les endpoints avec Postman ou Thunder Client

Erreurs courantes à éviter

  • Oublier de redémarrer le serveur après modification des schémas
  • Laisser les permissions API ouvertes en production
  • Ne pas configurer correctement les variables d'environnement
  • Ignorer les erreurs de validation des types de contenu

Pour aller plus loin

Découvrez nos formations Strapi complètes pour maîtriser les plugins, l'authentification et le déploiement en production.