Ce qu'est Spunto CMS
Un espace de travail à la Notion dont le contenu est aussi servi en CMS headless par une API REST — les mêmes lignes, sans export.
Spunto CMS est un espace de travail où l'on écrit — des listes de cartes, un registre commun de propriétés typées, des corps de carte structurés en blocs, des vues sauvegardées avec filtres et tris — et une API qui le sert.
Il n'y a pas d'étape d'export, ni de chaîne de publication qui recopierait le
contenu ailleurs. Les lignes qu'un rédacteur modifie sont celles que l'API
renvoie. Quand quelqu'un change un statut dans l'interface, le POST …/query
suivant renvoie la nouvelle valeur, parce que cette valeur ne vit qu'à un seul
endroit.
Ce que cela vous apporte
Un modèle, deux publics
Les rédacteurs ont des listes, des cartes et des vues sauvegardées. Les consommateurs ont une API REST typée sur les mêmes tables — filtres, tris, pages keyset.
Un contrat versionné
La spécification OpenAPI est générée depuis les routes, commitée dans le dépôt et servie en direct. Un client TypeScript en est généré.
Accessible en écriture aux machines
Une clé API peut créer et modifier du contenu. Scripts, agents et imports passent par les mêmes routes que l'interface — rien n'est réservé à l'UI.
Isolé par espace de travail
Chaque tenant est séparé par la sécurité au niveau des lignes de Postgres,
pas par une clause WHERE qu'il faudrait penser à écrire.
Deux surfaces de documentation
Ce site est la documentation produit : ce que sont les objets, comment ils s'articulent et comment travailler avec eux.
La référence de l'API est une surface distincte, générée. Chaque route, chaque paramètre et chaque schéma y est décrit, à partir de la spécification dont est aussi généré le client :
- Référence de l'API — la référence interactive Scalar.
/openapi.json— la spécification brute.
La référence est générée, ce site est écrit
Rien ici ne reprend la liste des paramètres d'une route. Quand les deux se contredisent, c'est la référence qui a raison : elle vient du code, ce site vient d'un humain.
Par où commencer
Pour le voir fonctionner, passez par le démarrage rapide : connexion, création d'une liste, relecture par l'API, en une dizaine de minutes.
Pour le brancher sur un site web, le guide Next.js construit un blog de bout en bout — client typé, corps rendus, images, et pages qui se rafraîchissent quand un rédacteur publie.
Pour comprendre le modèle avant d'y toucher, commencez par listes et cartes ; le reste de la section Concepts s'appuie sur cette page.
Pour y brancher quelque chose, la section API couvre l'authentification, la lecture, l'écriture et le journal d'événements.
Et si vous vous demandez si l'outil vous convient, lisez d'abord ce qu'il ne fait pas. C'est court, et c'est honnête.
Ce que ce n'est pas
REST uniquement. Il n'y a pas de point d'accès GraphQL, et il n'y en aura pas — c'est une décision tranchée, pas un point de feuille de route.