guides

Guide Contentful CMS : Fonctionnalités, Tarifs, API GraphQL & Exemples de Code [2026]

Écrit par Mert Batur
Apr 6, 2026
22 lecture
Guide Contentful CMS : Fonctionnalités, Tarifs, API GraphQL & Exemples de Code [2026]

Contentful est un headless CMS API-first qui stocke votre contenu dans un hub centralisé et le délivre via des API REST et GraphQL vers n'importe quel frontend — web, mobile, IoT, affichage numérique, peu importe ce que vous construisez. Ce guide couvre tout ce que les autres passent sous silence : de vrais exemples de code, des tarifs réels et des limites honnêtes.

Nous utilisons Sanity (un concurrent direct de Contentful) en production sur quatre sites et dix langues, donc nous abordons le sujet en praticiens, pas comme des revendeurs.

Résumé rapide

DétailInfo
TypeHeadless CMS (API-first)
Fondé2013, Berlin
Idéal pourÉquipes enterprise, contenu multicanal, projets à forte localisation
Pas idéal pourDéveloppeurs solo avec budget serré, blogs simples, équipes cherchant de l'édition visuelle dès le départ
Niveau gratuitOui — 10 utilisateurs, 100K appels API/mois, 1 espace
Plans payantsÀ partir de $300/mois (Lite) jusqu'à Enterprise sur devis
APIsREST (CDA, CMA, CPA) + GraphQL
Modélisation de contenuStructurée : types de contenu, champs, références, validations
Fonctionnalités IAAI Actions, Contentful Studio, personnalisation Ninetailed
LocalisationSupport natif des locales, pas de gestion des traductions intégrée
Open SourceNon
Principaux concurrentsSanity, Strapi, Storyblok, Payload, Hygraph

Qu'est-ce que Contentful ?

Contentful est un headless CMS cloud-native et API-first — ou comme l'entreprise le nomme désormais, une "plateforme de contenu composable". Contrairement aux systèmes traditionnels comme WordPress qui associent la gestion de contenu à un frontend, Contentful stocke le contenu structuré de façon centralisée et le délivre via des API vers n'importe quel canal.

Le concept clé, c'est l'architecture découplée. Votre contenu vit dans le cloud de Contentful. Votre frontend — qu'il s'agisse d'un site Next.js, d'une application React Native ou d'un écran connecté — récupère ce contenu via les API de Contentful au moment du build ou à l'exécution. Le contenu ne sait pas et ne se préoccupe pas de l'endroit où il finit.

Fondé à Berlin en 2013, Contentful est devenu l'un des plus grands fournisseurs de headless CMS. Des marques comme Spotify, Vodafone, Chanel et Atlassian font tourner leurs opérations de contenu dessus. Ce n'est pas open source et il n'y a pas d'option d'hébergement propre — c'est du SaaS uniquement, ce qui compte si vous avez des contraintes de conformité liées à la résidence des données.

Selon la documentation officielle de Contentful, la plateforme se positionne comme une infrastructure pour le contenu — un hub qui s'intercale entre votre équipe éditoriale et vos expériences numériques.

Comment fonctionne Contentful ?

Contentful suit une architecture en trois couches : vous définissez votre Modèle de Contenu (le schéma), vous créez du Contenu (les entrées), puis vous le délivrez via des API. Le contenu est agnostique du canal — le même article de blog peut alimenter votre site web, votre application mobile et votre newsletter sans aucune duplication.

Tout passe par les API. Il n'y a pas de rendu côté serveur intégré, pas de templates, pas de couche thème. Vous construisez le frontend comme bon vous semble, et Contentful gère le stockage et la livraison du contenu.

Les trois APIs

Contentful vous donne trois APIs distinctes, chacune avec son propre rôle et son authentification :

  • Content Delivery API (CDA) : Accès en lecture seule au contenu publié. Adossée au CDN de Fastly, donc les requêtes mises en cache sont rapides et illimitées. Les requêtes non mises en cache sont limitées à 55 par seconde.
  • Content Management API (CMA) : Accès en lecture-écriture pour créer et mettre à jour du contenu par programmation. Limitée à 10 requêtes par seconde. C'est ce que vous utiliseriez pour les migrations, les imports en masse ou les pipelines CI/CD.
  • Content Preview API (CPA) : Identique à la CDA mais sert le contenu brouillon. Parfait pour créer des modes de prévisualisation dans votre frontend — les éditeurs voient les modifications non publiées avant de cliquer sur publier.

Les trois supportent REST et GraphQL. L'authentification se fait via des tokens Bearer, avec des tokens séparés pour la livraison et la gestion.

Environnements et Spaces

Pensez aux Spaces comme des projets et aux Environnements comme des branches git pour votre contenu. Vous pourriez avoir un environnement master pour la production et un environnement staging où les éditeurs peuvent travailler sans affecter le contenu en ligne.

Les environnements supportent les alias — vous pouvez pointer l'alias master vers un nouvel environnement pour des promotions de contenu sans interruption de service. Si vous choisissez un framework frontend à associer à Contentful, ce modèle d'environnement fonctionne bien avec les déploiements de prévisualisation sur des plateformes comme Vercel ou Netlify.

Les webhooks vous permettent de déclencher des builds, de synchroniser avec des systèmes externes ou de lancer des workflows à chaque changement de contenu. La plupart des équipes les connectent à leur pipeline CI/CD pour reconstruire leur site statique à chaque événement de publication.

La modélisation de contenu dans Contentful

La modélisation de contenu consiste à définir la structure de votre contenu — le "schéma" qui détermine quels champs existent, quels types de données ils contiennent et comment les types de contenu se relient entre eux. D'après notre expérience, c'est là que Contentful brille vraiment par rapport aux options CMS plus simples.

Vous concevez essentiellement un schéma de contenu, similaire aux tables d'une base de données mais plus flexible. Un type de contenu "Article de blog" pourrait avoir un titre (texte court), un corps (texte riche), un auteur (référence vers un type de contenu Auteur) et des tags (tableau de chaînes de caractères). Chaque entrée que vous créez suit cette structure.

Types de champs et validations

Contentful propose une gamme solide de types de champs :

  • Texte court (Symbol) : Titres, slugs, libellés — jusqu'à 256 caractères
  • Texte long (Text) : Markdown ou texte brut, sans limite de caractères
  • Texte riche : Basé sur JSON (pas HTML), vous donne un contrôle total sur le rendu
  • Nombre : Entier ou décimal
  • Date/Heure : Format ISO 8601
  • Booléen : Bascules vrai/faux
  • Média (Asset) : Images, vidéos, documents — stockés dans le pipeline d'assets de Contentful
  • Référence (Link) : Connecte des entrées à d'autres entrées ou assets
  • Objet JSON : Données structurées libres
  • Localisation : Paires latitude/longitude

Chaque champ supporte des validations : requis, unique, expressions régulières, limites de taille et messages de validation personnalisés. Vous pouvez également définir des options d'apparence qui contrôlent comment le champ s'affiche dans l'interface de l'éditeur.

Références et entrées liées

Les références permettent de connecter des types de contenu. Une référence "Auteur" sur un Article de blog pointe vers une entrée Auteur. Un champ "Articles connexes" peut référencer plusieurs entrées d'articles. Cela crée un graphe de contenu — des entrées liées à d'autres entrées, interrogeables en un seul appel API.

Voici à quoi ressemble réellement la définition d'un type de contenu Article de blog quand vous le créez via la Content Management API :

json
{
  "name": "Blog Post",
  "fields": [
    { "id": "title", "type": "Symbol", "required": true },
    { "id": "slug", "type": "Symbol", "validations": [{ "unique": true }] },
    { "id": "body", "type": "RichText" },
    { "id": "author", "type": "Link", "linkType": "Entry" },
    { "id": "publishDate", "type": "Date" },
    { "id": "tags", "type": "Array", "items": { "type": "Symbol" } }
  ]
}

C'est le genre de chose que vous stockeriez dans un dépôt de contrôle de version et appliqueriez via des scripts de migration. Aucun concurrent ne montre ça dans ses guides Contentful — ils parlent de modélisation de contenu de façon abstraite sans montrer ce que ça donne vraiment en code.

Interroger le contenu : APIs REST et GraphQL

Contentful fournit des APIs REST et GraphQL pour récupérer du contenu. REST est simple pour les requêtes basiques. GraphQL est plus adapté quand vous avez besoin de données imbriquées, de plusieurs types de contenu en une seule requête, ou que vous voulez éviter la sur-récupération. Les deux utilisent les mêmes tokens d'authentification.

L'endpoint GraphQL est auto-généré à partir de votre modèle de contenu. Chaque type de contenu que vous créez devient un type interrogeable dans le schéma, avec filtrage, tri et pagination intégrés. L'endpoint se trouve à :

text
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}

Selon la documentation GraphQL de Contentful, le schéma se met à jour automatiquement dès que vous modifiez vos types de contenu — pas de gestion manuelle du schéma requise.

Exemples de requêtes GraphQL

Voici une requête simple pour récupérer vos dix articles de blog les plus récents avec leurs auteurs :

graphql
query {
  blogPostCollection(limit: 10, order: publishDate_DESC) {
    items {
      title
      slug
      publishDate
      author {
        name
      }
    }
  }
}

Besoin de filtrer par tag et de récupérer du contenu en allemand ? Ajoutez une clause where et un paramètre locale :

graphql
query {
  blogPostCollection(
    where: { tags_contains_some: ["javascript"] }
    locale: "de"
  ) {
    items {
      title
      body {
        json
      }
    }
  }
}

Un point d'attention : les requêtes GraphQL ont des limites de complexité. Les requêtes profondément imbriquées avec plusieurs références liées peuvent atteindre le plafond. Contentful calcule la complexité en fonction du nombre de nœuds et de la profondeur de la requête. Si vous récupérez des articles de blog avec leurs auteurs, catégories, articles connexes et l'auteur de chaque article connexe — ça s'accumule vite.

Les bases de l'API REST

L'API REST est plus simple mais nécessite davantage de requêtes pour les données imbriquées. Une récupération basique des articles de blog appelle https://cdn.contentful.com/spaces/{SPACE_ID}/entries?content_type=blogPost. Vous obtenez du JSON avec un tableau items plat et un objet includes séparé pour les entrées liées que vous devrez résoudre côté client.

Si vous travaillez avec TypeScript, le SDK contentful.js de Contentful gère la résolution des liens et la génération de types automatiquement. Pour des appels fetch bruts, voici le JavaScript minimal pour interroger l'API GraphQL :

javascript
const response = await fetch(
  `https://graphql.contentful.com/content/v1/spaces/${SPACE_ID}`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${CDA_TOKEN}`,
    },
    body: JSON.stringify({ query }),
  }
);
const { data } = await response.json();

C'est tout. Pas de SDK requis, pas d'étape de build, pas de dépendances. Ça fonctionne dans Node.js, Deno, Cloudflare Workers, le navigateur — partout où vous pouvez faire des requêtes HTTP.

Fonctionnalités clés à connaître

Contentful embarque un large ensemble de fonctionnalités, mais toutes n'ont pas le même impact. Voici celles qui affectent vraiment votre expérience au quotidien et vos décisions d'architecture.

Localisation (points forts et lacunes)

Le modèle de localisation de Contentful est solide au niveau de l'infrastructure. Vous définissez des locales pour votre espace (plus de 100 sur les plans Enterprise), et chaque champ peut stocker des valeurs par locale. Les remplacements de locale au niveau du champ signifient que votre titre allemand peut différer de l'anglais tout en partageant la même image hero.

La lacune, c'est la gestion des traductions. Contentful vous donne les champs pour stocker les traductions, mais pas le workflow pour les produire. Pas de mémoire de traduction, pas de glossaire, pas de système d'attribution, pas de suivi de progression. Vous avez besoin d'une intégration tierce — Phrase, Smartcat ou Lokalise — pour gérer le vrai processus de traduction. Pour les équipes gérant 10+ langues (nous en gérons 10 sur nos sites), cette lacune devient vite coûteuse.

Environnements et branches

Les environnements fonctionnent comme des branches git pour votre modèle de contenu et vos entrées. Créez un environnement staging, apportez des modifications au schéma, testez avec du contenu, puis promouvez vers master quand vous êtes prêt. Les alias vous permettent de switcher l'environnement vers lequel master pointe sans changer les URLs des API.

C'est vraiment utile pour les migrations de schéma. Vous pouvez tester un nouveau type de contenu dans un environnement isolé, vérifier que le frontend le gère correctement, puis promouvoir — le tout sans toucher au contenu de production. La plupart des équipes que nous avons vues utilisent deux ou trois environnements : production, staging et parfois une branche pour les migrations importantes.

Autres fonctionnalités à mentionner :

  • Rôles et permissions : Contrôle d'accès granulaire — limitez les éditeurs à des types de contenu spécifiques, bloquez l'accès à la publication pour les rôles juniors, rôles personnalisés sur les plans Enterprise, SSO
  • Webhooks : Déclenchez des builds, des notifications Slack ou des workflows externes sur n'importe quel événement de contenu
  • Texte riche : Basé sur JSON, offrant un contrôle total sur le rendu mais nécessitant des rendus personnalisés pour chaque framework frontend
  • App Framework : Marketplace avec des extensions pour les éditeurs de champs personnalisés, les widgets de barre latérale et les intégrations
  • Image API : Redimensionnement, recadrage, conversion de format à la volée (WebP, AVIF) et recadrage par point focal — pas besoin de CDN d'images séparé

Les nouveautés de Contentful en 2026

Contentful a livré des mises à jour significatives tout au long de 2025 et au début de 2026, et aucun guide concurrent n'en parle. Si vous évaluez Contentful sur la base d'informations de 2023 ou 2024, vous travaillez avec un tableau incomplet.

AI Actions et automatisation du contenu

Contentful a lancé les AI Actions — des workflows de contenu automatisés alimentés par des grands modèles de langage directement dans l'éditeur. Ils gèrent les brouillons de traduction, la génération de métadonnées SEO, la rédaction de textes alternatifs, les ajustements de ton et les résumés de contenu. Vous y accédez depuis la barre latérale de l'éditeur, et ils opèrent sur l'entrée que vous modifiez actuellement.

Selon la couverture de Diginomica, les AI Actions font partie de la démarche plus large de Contentful pour se positionner en tant que plateforme d'expérience digitale complète (DXP), pas seulement un headless CMS. La fonctionnalité est vraiment utile pour automatiser les tâches éditoriales répétitives, même si le résultat de traduction nécessite encore une relecture humaine — c'est un premier jet, pas un produit fini.

Contentful Studio (constructeur visuel)

Contentful Studio est passé en disponibilité générale au printemps 2024 et a bien mûri tout au long de 2025. C'est un constructeur de pages visuelles qui permet aux non-développeurs de composer des pages avec des composants en glisser-déposer et un aperçu en direct. Si vous avez entendu la critique "Contentful n'a pas d'édition visuelle" — Studio est la réponse, avec quelques nuances toutefois.

Studio nécessite une intégration frontend (vos composants doivent être enregistrés avec le SDK de Studio), et c'est un module complémentaire payant, non inclus dans les plans de base. Pour les équipes qui réclamaient un constructeur de pages à la WordPress sur le modèle de contenu structuré de Contentful, c'est désormais une vraie option. Storyblok a encore l'avantage pour les workflows visuels en premier, mais l'écart se réduit.

Personnalisation avec Ninetailed

Contentful a acquis Ninetailed en 2024 et l'a rebrandé en Contentful Personalization. Comme CMS Critic le rapporte, cela vous donne des tests A/B natifs, une segmentation d'audience et des suggestions de variantes pilotées par l'IA — le tout accessible depuis un onglet Optimization dans l'éditeur.

C'est notable parce que la personnalisation nécessitait historiquement un fournisseur séparé (Optimizely, Dynamic Yield, etc.). L'avoir intégré au CMS réduit la complexité d'intégration. La nuance : Ninetailed est un produit séparé avec sa propre tarification. Ce n'est pas "gratuit avec Contentful."

Tarifs Contentful : Ce que ça coûte vraiment

Contentful propose quatre niveaux, mais la plupart des guides concurrents se contentent de les nommer sans donner les vrais chiffres. Voici ce à quoi vous pouvez vous attendre en avril 2026, d'après la page de tarifs de Contentful :

PlanPrixUtilisateursAppels API/moisBande passante CDNEspaces
Gratuit (Community)$010100K50 Go1 Starter
Lite$300/mois201M100 GoMultiple
PremiumSur devis (~$2K+/mois)IllimitéIllimitéPersonnaliséPersonnalisé
EnterpriseSur devis (5 à 6 chiffres/an)IllimitéIllimitéPersonnaliséPersonnalisé

"Coût mensuel Contentful par niveau"

Tableau de données
"Coût mensuel Contentful par niveau"
"Plan""Coût mensuel"
"Gratuit"0
"Lite"300
"Premium"2000
"Enterprise"5000

Le niveau gratuit est généreux pour le prototypage et l'apprentissage. Vous obtenez 10 utilisateurs, 100K appels API et assez de bande passante pour construire un vrai projet. Mais les coûts escaladent vite dès que vous en sortez.

Coûts cachés à prévoir :

  • Dépassements d'API sur Lite : Dépassez 1M d'appels/mois et vous verrez des postes de dépassement sur votre facture
  • Coûts des locales : Chaque locale supplémentaire compte dans les limites de votre espace — 50 locales au niveau du champ, ça s'accumule
  • Contentful Studio : Le constructeur visuel est un module complémentaire payant, non inclus dans Lite ni dans certains plans Premium
  • Personnalisation Ninetailed : Produit séparé, contrat séparé, tarification séparée
  • Services professionnels : L'aide à la migration, l'onboarding et la formation sont facturés séparément
  • Rendus de texte riche : Pas un coût direct, mais le temps de développement pour construire des rendus personnalisés pour votre framework est bien réel

Notre avis honnête : Le niveau gratuit de Contentful est solide pour l'évaluation et les petits projets. Mais si le budget est une contrainte principale, les alternatives CMS open source comme Strapi ou Payload éliminent complètement les coûts de licence — vous ne payez que l'hébergement.

Contentful vs Sanity vs Strapi : Comparaison honnête

Ce sont les trois options de headless CMS qui reviennent dans presque toutes les évaluations. Nous avons construit des systèmes en production sur Sanity, donc nous en connaissons les forces et faiblesses de première main. Voici une comparaison honnête :

FonctionnalitéContentfulSanityStrapi
TypeSaaS (source fermée)SaaS + auto-hébergéOpen source (auto-hébergé ou Cloud)
Niveau gratuit10 utilisateurs, 100K appels100K appels API, 3 utilisateursIllimité (auto-hébergé)
GraphQLNatifPlugin (GROQ est primaire)Natif
Modélisation de contenuInterface + APICode (schéma en code)Interface + code
Collaboration temps réelOuiOui (Presence API)Limitée
Édition visuelleStudio (module complémentaire)Visual Editing (natif)Non
LocalisationLocales nativesPlugin/personnaliséPlugin (i18n)
TarifsÀ partir de $300/moisÀ partir de $0 (niveau gratuit généreux)Gratuit (auto-hébergé)
Idéal pourEnterprise, multicanalDéveloppeurs-first, schémas flexiblesBudget réduit, auto-hébergé

Contentful gagne pour les équipes enterprise avec de grandes opérations de contenu et des besoins stricts en gouvernance. Le système de rôles mature, le SSO, les journaux d'audit et la SLA à 99,99% sur les plans Enterprise sont difficiles à égaler.

Sanity gagne pour l'expérience développeur et la flexibilité du schéma. Si vous préférez le schéma en code, voulez la puissance de requête de GROQ, et appréciez les fonctionnalités de collaboration en temps réel, Sanity est le meilleur choix. Lisez notre guide complet Sanity CMS pour aller plus loin.

Strapi gagne sur le coût. C'est gratuit à auto-héberger sans limites d'appels API. Si vous avez les capacités DevOps pour gérer votre propre infrastructure et n'avez pas besoin d'un support enterprise, Strapi vous donne le plus de CMS par euro.

Pour une comparaison plus large incluant Storyblok, Payload et Hygraph, consultez notre comparaison complète des headless CMS.

Limitations à connaître avant de choisir Contentful

Tout CMS implique des compromis. Voici ceux de Contentful — avec des chiffres précis, pas des généralités vagues. Nous en avons rencontré plusieurs lors de l'évaluation de Contentful pour notre propre pipeline de contenu.

Les limites de taux sont réelles. La CDA autorise 55 requêtes non mises en cache par seconde. Les réponses en cache CDN sont illimitées, mais si votre application contourne le cache (rendu côté serveur à chaque requête, par exemple), vous atteindrez les limites vite. La CMA est encore plus stricte à 10 requêtes par seconde — ce qui compte pour les scripts de migration et les imports en masse.

Pas d'édition visuelle intégrée (sans payer en plus). Contentful Studio existe, mais c'est un module complémentaire payant qui nécessite une intégration frontend. Si votre équipe s'attend à un constructeur de pages à la WordPress dans le produit de base, préparez-vous à cette conversation. Storyblok inclut l'édition visuelle à tous les niveaux.

Pas de gestion des traductions. Vous obtenez des champs de locale — c'est tout. Pas de workflows de traduction, pas de système d'attribution, pas de mémoire de traduction, pas de suivi de progression. Pour une plateforme qui vend la localisation comme fonctionnalité clé, l'expérience de traduction réelle repose entièrement sur des outils tiers comme Phrase, Smartcat ou Lokalise.

Dépendance au développeur pour tout ce qui touche au frontend. Les éditeurs de contenu peuvent créer et gérer des entrées. Ils ne peuvent pas modifier les mises en page, ajouter de nouvelles sections, modifier la navigation ou mettre à jour le frontend de quelque manière que ce soit sans un développeur. C'est inhérent à l'architecture headless, mais amplifié dans Contentful parce que le produit de base n'inclut pas de constructeur de pages.

La tarification devient imprévisible à l'échelle. Les dépassements d'appels API, les limites basées sur les locales, les coûts supplémentaires pour Studio et la Personnalisation, et les services professionnels créent un modèle de tarification difficile à prévoir. Plusieurs équipes avec qui nous avons parlé ont été surprises par leur première facture après le niveau gratuit.

La complexité du texte riche. Le texte riche de Contentful est basé sur JSON, pas HTML. Chaque framework frontend a besoin d'un rendu personnalisé — @contentful/rich-text-react-renderer pour React, rich-text-html-renderer pour le JS vanilla, etc. Ça vous donne un contrôle total sur le rendu, mais c'est significativement plus de travail de développement que les concurrents basés sur HTML.

Dépendance fournisseur. Source fermée, SaaS uniquement, pas d'option d'auto-hébergement. Votre contenu est exportable via API, mais votre modèle de contenu, vos workflows et vos intégrations sont spécifiques à Contentful. Si les tarifs changent ou si des fonctionnalités sont dépréciées, vos options sont limitées.

Qui devrait (et ne devrait pas) utiliser Contentful

Contentful est une plateforme solide, mais ce n'est pas le bon choix pour tous les projets. Voici un cadre de décision pour vous aider à vous situer.

Utilisez Contentful si :

  • Vous êtes une équipe enterprise gérant du contenu sur plusieurs canaux (web, mobile, IoT, affichage numérique)
  • Vous avez besoin d'une localisation native avec 50+ locales et des remplacements au niveau du champ
  • Vous voulez une plateforme mature et éprouvée avec un support dédié et une SLA à 99,99%
  • Votre équipe comprend des développeurs à l'aise avec l'architecture API-first
  • Vous avez besoin de rôles granulaires, de permissions, de journaux d'audit et de SSO

Évitez Contentful si :

  • Vous êtes un développeur solo ou une petite équipe avec des contraintes budgétaires — regardez du côté de Strapi ou Payload
  • Vous voulez un constructeur de pages visuel inclus dans le produit de base — regardez du côté de Storyblok
  • Vous préférez des définitions de schéma code-first et une flexibilité maximale — regardez du côté de Sanity
  • Vous avez besoin d'un simple CMS de blog — WordPress ou Ghost est moins cher et plus rapide à mettre en place
  • Vous voulez vous auto-héberger pour des raisons de conformité — regardez du côté de Strapi ou Payload
Si vous avez besoin de...ChoisissezParce que
Gouvernance de niveau enterpriseContentfulRôles matures, SSO, journaux d'audit, SLA à 99,99%
Flexibilité développeur maximaleSanitySchéma en code, GROQ, portable text
Zéro coût de licenceStrapi ou PayloadOpen source, auto-hébergeable
Édition visuelle dès le départStoryblokL'éditeur visuel est le produit principal
Blog simpleWordPress ou GhostDélai de mise en ligne le plus court

Pour un regard plus approfondi sur toutes ces alternatives, consultez notre comparaison complète des headless CMS.

Débuter : Vos 15 premières minutes avec Contentful

Voici un walkthrough pratique — pas de théorie, mais les étapes exactes pour passer de zéro à interroger du contenu via GraphQL en environ 15 minutes.

Étape 1 : Créez un compte. Rendez-vous sur contentful.com et créez un compte gratuit. Pas de carte de crédit nécessaire.

Étape 2 : Créez un Space. Un Space est votre conteneur de projet. Le niveau gratuit vous donne un Starter Space. Donnez-lui un nom descriptif.

Étape 3 : Définissez un type de contenu. Allez dans Content Model, cliquez sur "Add content type" et créez un type "Article". Ajoutez des champs : Titre (Texte court, requis), Slug (Texte court, validation unique), Corps (Texte riche), Image de couverture (Média) et Date de publication (Date et heure).

Étape 4 : Créez une entrée. Naviguez vers Content, cliquez sur "Add Article" et remplissez les champs. Cliquez sur Publish.

Étape 5 : Récupérez vos clés API. Allez dans Settings -> API Keys. Créez une nouvelle clé API. Vous obtiendrez un Space ID, un token Content Delivery API et un token Content Preview API. Sauvegardez-les.

Étape 6 : Interrogez via le Playground GraphQL. Ouvrez cette URL dans votre navigateur (remplacez avec vos identifiants) :

text
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}/explore?access_token={CDA_TOKEN}

Étape 7 : Récupérez depuis votre application. Utilisez l'exemple JavaScript fetch de la section APIs ci-dessus — substituez votre Space ID et votre token CDA, et vous récupérez du contenu en direct.

Conseil pro : L'URL du Playground GraphQL n'est pas évidente dans l'interface Contentful. Vous pouvez la trouver sous Settings -> API Keys -> GraphQL Playground URL, ou la construire manuellement en utilisant le template ci-dessus. Mettez-la en favori — vous l'utiliserez constamment pendant le développement.

FAQ

Qu'est-ce que Contentful CMS et comment ça fonctionne ?

Contentful est un headless CMS API-first qui stocke du contenu structuré dans un hub cloud et le délivre via des APIs REST et GraphQL. Contrairement à WordPress, il n'a pas de frontend — vous construisez le vôtre avec n'importe quel framework. Les éditeurs de contenu gèrent les entrées via l'application web de Contentful, et les développeurs récupèrent ce contenu via les APIs.

Contentful est-il gratuit ?

Oui, Contentful offre un niveau Community gratuit qui inclut 10 utilisateurs, 100K appels API par mois, 50 Go de bande passante CDN et un Starter Space. C'est suffisant pour le prototypage et les petits projets. Les plans payants commencent à $300/mois pour le niveau Lite, avec des niveaux Premium et Enterprise sur devis.

Qu'est-ce que la modélisation de contenu dans Contentful ?

La modélisation de contenu consiste à définir des types de contenu structurés avec des champs, des validations et des références — comme concevoir un schéma de base de données mais pour le contenu. Vous créez des types comme "Article de blog" ou "Produit" avec des champs spécifiques (titre, corps, image, catégorie), et chaque entrée suit cette structure. C'est la fondation de Contentful.

Comment Contentful se compare-t-il à WordPress ?

Contentful est headless (API uniquement, pas de frontend intégré), tandis que WordPress associe la gestion du contenu au rendu basé sur des thèmes. Contentful excelle dans la diffusion multicanal — le même contenu peut servir le web, le mobile et l'IoT. WordPress excelle par sa simplicité — vous obtenez un site fonctionnel en quelques minutes sans développeur.

Contentful est-il adapté à un usage enterprise ?

Oui, Contentful est l'une des plateformes headless CMS les plus adoptées en entreprise. Les plans Enterprise incluent SSO, contrôle d'accès granulaire basé sur les rôles, journaux d'audit, support dédié, SLA à 99,99% et appels API illimités. Des entreprises comme Spotify, Vodafone, Chanel et Atlassian l'utilisent pour des opérations de contenu à grande échelle.

Quels sont les inconvénients de Contentful ?

Les principales limitations incluent : pas d'édition visuelle intégrée dans le produit de base (Studio est un module complémentaire payant), imprévisibilité des tarifs à l'échelle en raison des dépassements d'API et des coûts supplémentaires, pas de workflow de gestion des traductions, dépendance au développeur pour tous les changements frontend, JSON de texte riche nécessitant des rendus personnalisés, et dépendance fournisseur sans option d'auto-hébergement.

Contentful supporte-t-il GraphQL ?

Oui, nativement. Chaque espace Contentful dispose d'un schéma GraphQL auto-généré basé sur vos types de contenu. Vous pouvez interroger avec filtrage, pagination, tri et requêtes spécifiques à une locale. L'endpoint est à graphql.contentful.com/content/v1/spaces/{SPACE_ID}, authentifié avec votre token Content Delivery API.

Combien coûte Contentful par mois ?

Le niveau gratuit coûte $0. Lite est à $300/mois avec 20 utilisateurs et 1M d'appels API. Premium commence autour de $2.000+/mois avec des tarifs sur mesure. Enterprise se situe entre cinq et six chiffres annuellement. Attention aux coûts cachés : dépassements d'appels API, frais du module Contentful Studio, tarification Ninetailed et services professionnels.

Contentful peut-il gérer plusieurs langues ?

Oui, Contentful a une gestion native des locales avec des remplacements au niveau du champ — chaque champ peut stocker différentes valeurs par locale. Cependant, il n'y a pas de workflow de traduction intégré, ni de mémoire, ni de glossaire. Vous avez besoin d'intégrations tierces comme Phrase, Smartcat ou Lokalise pour gérer le vrai processus de traduction à l'échelle.

Qu'est-ce que Contentful Studio ?

Contentful Studio est un module complémentaire de constructeur de pages visuelles passé en disponibilité générale au printemps 2024. Il permet aux non-développeurs de composer des pages en utilisant des composants en glisser-déposer avec un aperçu en direct. Il nécessite une intégration frontend (vos composants doivent être enregistrés avec le SDK de Studio) et c'est un module complémentaire payant — non inclus dans les plans Contentful de base.

Tags

guide-contentfulheadless-cmsmodélisation-contenugraphqlcms-api-first

Partager cet article

Démarrez Votre Projet

Prêt à construire quelque chose d'extraordinaire ?

Transformons votre vision en réalité. Notre équipe est prête à vous aider à créer un logiciel qui fait la différence.