Clustraly
Jetons API, webhooks & API REST

Diffusez vos pages publiées partout avec l'API REST publique lecture des pages (/api/v1)

API REST publique lecture des pages (/api/v1) une fonctionnalité du module Jetons API, webhooks & API REST de Clustraly. L'API REST publique de lecture des pages expose vos pages publiées et publiques en lecture seule, via des endpoints /api/v1/pages authentifiés au scope content:read.

Un endpoint REST propre et authentifié lit vos pages publiées, prêtes à afficher partout. L'IA structure la donnée, vous décidez de l'expérience.

Lecture des pages

Un seul point d'accès pour lire toutes vos pages publiées

Vous exposez vos pages là où vos lecteurs se trouvent. GET /api/v1/pages renvoie une liste paginée de vos pages publiées et publiques, et GET /api/v1/pages/{slug} livre le détail d'une page précise.

Pas de synchronisation manuelle : votre contenu déjà publié devient immédiatement lisible par n'importe quelle application autorisée.

  • Liste paginée via GET /api/v1/pages
  • Détail par slug via GET /api/v1/pages/{slug}
  • Accès strictement en lecture seule
Lire mes pages via l'API
Pagination, slug & langue

Récupérez exactement les pages que vous voulez

Vous parcourez votre contenu par lots grâce à la pagination intégrée, ciblez une page par son slug, et filtrez par langue avec le paramètre ?lang.

  • Pagination intégrée sur la liste
  • Accès direct par slug
  • Filtre multilingue via ?lang
Détail d'une page

Le contenu complet d'une page, prêt à afficher

GET /api/v1/pages/{slug} renvoie tout ce qu'il faut pour un rendu fidèle : template, métadonnées et image à la une. La sérialisation applique la locale, pour une réponse alignée sur la langue demandée.

  • Template, méta et image à la une
  • Locale appliquée à la sérialisation
  • Réponse structurée par ApiTransformer
Cas d'usage

Alimentez un front découplé, une app ou un second site

Vous branchez un front découplé (headless), une application mobile ou un site partenaire directement sur vos pages. Le CMS reste la source, l'affichage vous appartient.

L'IA propose une donnée propre et normalisée ; vous décidez de la mise en scène côté client.

  • Front découplé / JAMstack
  • Application mobile ou service tiers
  • Site partenaire ou vitrine secondaire
Garde-fous

Une lecture verrouillée sur le publié et le public

Le périmètre publié + public est imposé côté serveur via publishedPages : aucun brouillon ni page privée n'est jamais exposé. Chaque appel exige un jeton Bearer et le scope content:read.

Un whitelisting de champs par ApiTransformer écarte tout champ interne, sans jamais sérialiser le modèle brut.

  • Périmètre publié+public côté serveur
  • Authentification Bearer, scope content:read
  • Whitelisting de champs, aucune fuite interne
Pourquoi ça compte

L'IA propose, vous décidez

Clustraly structure et sécurise la lecture de vos pages ; vous choisissez où et comment les afficher. Rien n'est écrit, rien de privé n'est exposé vous gardez la main sur votre contenu.

FAQ

Questions fréquentes

Quels endpoints expose la lecture des pages ?
Deux : GET /api/v1/pages pour la liste paginée de vos pages publiées et publiques, et GET /api/v1/pages/{slug} pour le détail d'une page (template, méta, image à la une).
Peut-on modifier une page via cette API ?
Non. Cet accès est strictement en lecture seule. L'écriture relève d'un autre périmètre et d'un scope distinct ; la lecture des pages n'exige que le scope content:read.
Comment s'authentifier et quel scope faut-il ?
Chaque appel exige un en-tête Authorization: Bearer avec un jeton actif et le scope content:read. Sans jeton valide, l'API répond en 401 ; avec un scope insuffisant, en 403.
Un brouillon ou une page privée peut-il fuiter ?
Non. Le périmètre publié + public est imposé côté serveur via publishedPages, et la sérialisation applique un whitelisting de champs qui écarte tout champ interne.
Prêt à commencer ?

Ouvrez vos pages à vos intégrations, en toute sûreté

Activez un jeton avec le scope content:read et lisez vos pages publiées via /api/v1/pages. Lecture seule, périmètre publié+public imposé côté serveur, réponses filtrées par ApiTransformer : vous diffusez votre contenu partout sans jamais l'exposer au risque.