CMA (Content Management API)

Dernière mise à jour : 3 juillet 2026

La CMA (Content Management API) est une API de gestion qui permet de créer, lire, modifier et supprimer le contenu et les paramètres d'un Space. Vous pouvez effectuer en code, à l'identique, les opérations réalisées dans le studio de contenu (rédaction de contenu, publication, gestion des membres et des rôles, émission de jetons, etc.). La distribution du contenu publié aux visiteurs relève d'une API en lecture seule distincte, la CDA.

L'URL de base est https://cma.weegloo.com/v1. L'identité appelante est un Weegloo User (compte de plateforme Weegloo). Côté serveur, CI ou script, on envoie comme Bearer un Personal Access Token ; pour les interfaces d'administration côté navigateur, on envoie le jeton émis par le flux de connexion du studio de contenu. Les jetons ne sont pas compatibles avec l'ACMA, qui fonctionne sous l'identité d'un membre (ServiceUser) inscrit au produit.

Comportements communs

Les points ci-dessous s'appliquent à l'ensemble des ressources de la CMA. Chaque page de ressource part de ces comportements et ne traite que son contenu propre.

  • CRUD complet. La création (POST), la consultation (GET), la modification (PUT/PATCH) et la suppression (DELETE) sont toutes prises en charge. Contrairement à la CDA, qui est en lecture seule, l'écriture et la publication ont lieu ici.
  • La modification nécessite un en-tête de version. Lors de la modification d'une ressource, vous devez transmettre dans l'en-tête x-weegloo-version la valeur sys.version actuelle de la ressource. C'est un mécanisme qui empêche d'écraser une version qu'une autre personne aurait modifiée auparavant.
  • La modification partielle se fait avec PATCH. Pour ne changer que certains champs, envoyez un PATCH dont le corps est un RFC 6902 JSON Patch. Dans ce cas, le Content-Type de la requête est application/json-patch+json. Pour remplacer par un corps complet, utilisez PUT.
  • Il faut publier pour distribuer. Les Content, Media et Content Type doivent être créés ou modifiés dans la CMA puis publiés (Publish) pour être distribués via la CDA. Avant la publication, un Draft ou des modifications non publiées sont visibles dans le studio de contenu et dans la CMA, mais ne sont pas pris en charge par le canal de distribution.
  • Type de média de la réponse. Le Content-Type de la réponse est application/vnd.com.weegloo.v1+json;charset=UTF-8. Si vous envoyez Accept: application/json dans la requête, la négociation peut échouer : omettez l'en-tête Accept ou utilisez le même type vendor.

Les conventions communes telles que les paramètres de consultation de liste (limit, order, include, select, filtres, pagination par curseur), la structure sys et les codes d'erreur sont traitées dans Paramètres de requête communs, Propriétés système (sys), Conventions et Erreurs.

Ressources

Contenu

  • Content Type : définit le modèle (schéma) que suit le contenu. Détermine la composition des champs, leur type, leur caractère multilingue, leur caractère obligatoire et les règles de validation.
  • Content : crée, modifie et publie une donnée concrète produite à partir d'un Content Type.
  • Media : gère les ressources qui contiennent les fichiers téléversés (images, documents, etc.).
  • Tag : gère les courtes étiquettes qui classent les Content et les Media.
  • Locale : gère les paramètres de langue pris en charge par le Space (code, statut par défaut, fallbackCode).

Espace et organisation, autorisations

  • Organization : conteneur de plus haut niveau qui regroupe les Space. Le plan d'abonnement (plan) et les adhésions sont gérés à ce niveau.
  • Organization Membership : indique à quelle Organization une personne appartient et avec quelles autorisations ; permet d'inviter de nouveaux membres par e-mail.
  • Space : l'espace de travail qui contient l'ensemble du contenu d'un projet.
  • Space Membership : indique à quel Space un utilisateur appartient et avec quels SpaceRole.
  • SpaceRole : un ensemble d'autorisations attribué à un membre du Space. Il contient les actions par ressource (lecture, création, édition, suppression, publication) et des filtres de portée.

Jetons

  • Personal Access Token : jeton de longue durée qu'un Weegloo User utilise pour appeler la CMA, l'Upload et la CDA avec ses propres autorisations, depuis un serveur, une CI ou un script.
  • Delivery Access Token : jeton de lecture utilisé pour lire le contenu publié sur la CDA. Lors de son émission, il est lié à un seul SpaceRole qui en définit la portée de lecture.

Membres du produit (ServiceUser)

  • ServiceLogin : la configuration qui permet à un Space d'inscrire et de connecter les end-users (ServiceUser) de son propre produit via OAuth.
  • ServiceUserRole : un ensemble d'autorisations attribué aux ServiceUser inscrits au produit. Il s'applique à l'ACMA et à l'ACDA.
  • ServiceUser : un end-user du produit inscrit via ServiceLogin, autrement dit un compte membre.

Déploiement et intégration

  • Web Hosting : la ressource qui sert un site web statique compilé à l'adresse {subdomain}.weegloo.app.
  • Webhook : la configuration qui envoie une requête HTTP vers une URL externe désignée lorsqu'un événement se produit dans le Space (par exemple la création ou la publication d'un Content).
  • CDA : l'API en lecture seule qui distribue le contenu publié aux visiteurs.
  • ACMA : la version qui effectue les mêmes opérations de gestion sous l'identité d'un membre (ServiceUser).
  • Upload : l'API de téléversement qui relie un fichier déposé à la création d'un Media.