Créer un espace headless
Vous allez créer un espace headless — un site Structura qui vit entièrement dans le portail client, sans installation WordPress — et voir où vos articles apparaissent une fois les campagnes exécutées. Si votre site fonctionne sous WordPress, suivez plutôt Installer l’extension ; cette page s’adresse à tous les autres : Next.js, Astro, Nuxt, sites personnalisés et applications mobiles.
Un espace headless fonctionne comme tout autre site Structura : vous configurez votre marque, exécutez des campagnes et révisez les articles. La différence réside dans l’endroit où les articles aboutissent. Au lieu de publier dans WordPress, Structura les stocke dans le cloud et les sert depuis une API de diffusion publique que votre site web récupère — Structura devient votre backend de contenu.
Avant de commencer
Vous aurez besoin de :
- Un compte Structura — connectez-vous sur app.structurawp.com .
- L’adresse de votre site web public (ex.
https://example.com) — le site où vos lecteurs verront réellement les articles.
Vous n’avez pas besoin d’un développeur pour créer l’espace ou générer du contenu. Vous (ou votre développeur) n’avez besoin de modifications de code qu’à la toute fin, pour afficher les articles sur votre site — voir Ce qui se passe ensuite.
Étapes
-
Dans le portail client, choisissez Ajouter un site. Il vous sera demandé Où vit votre contenu ?
-
Sélectionnez la carte Headless et choisissez Créer un espace headless.
-
Saisissez l’URL de votre site web public — là où se trouvent réellement vos lecteurs. Structura l’utilise pour ancrer les suggestions SEO et s’assurer que les liens dans les articles diffusés pointent vers votre vrai domaine.
-
Le Nom du site se remplit à partir de l’URL ; modifiez-le si vous le souhaitez, puis sélectionnez Créer l’espace headless.
-
L’assistant de configuration s’ouvre, le même que celui utilisé par les sites WordPress : positionnement de marque, Persona et style visuel. Complétez-le (ou ignorez des étapes et revenez plus tard — l’espace existe déjà).
-
Créez votre première campagne. Le processus est identique à celui de WordPress — voir Votre première campagne ; tout ce qui figure sur cette page s’applique, à l’exception des écrans spécifiques à WordPress.
Ce qui se passe ensuite
- Les articles générés apparaissent sous Articles de votre site dans le portail, en attente de révision. Publier un article le rend disponible sur l’API de diffusion — il n’apparaît pas sur votre site web de lui-même.
- La page API de diffusion de votre site indique les adresses web exactes que votre site utilise pour récupérer les articles publiés, un flux par langue dans laquelle vous publiez. Envoyez cette page à votre développeur — les détails techniques se trouvent dans la Référence de l’API de diffusion headless.
- Une fois que votre site récupère et affiche le flux, les nouveaux articles transitent automatiquement : exécutions de campagnes → vous révisez → publier → votre site le récupère.
Problèmes courants
- « …est déjà connecté à cet espace de travail. » Chaque domaine peut être connecté une seule fois par espace de travail. Si le domaine appartient à un ancien site que vous avez supprimé, supprimez-le entièrement d’abord (voir Supprimer un site).
- Les articles sont publiés mais mon site web ne les affiche pas. L’API de diffusion ne fait que stocker et servir le contenu — votre site web doit le récupérer. Vérifiez avec votre développeur que l’intégration depuis la page API de diffusion est en place, et que votre site se reconstruit ou se revalide lorsque le contenu change.
- Mon blog est en plusieurs langues. Exécutez une campagne par langue. Chaque langue devient son propre flux sur la page API de diffusion.