CMA (Content Management API)

Zuletzt aktualisiert: 3. Juli 2026

Die CMA (Content Management API) ist eine Management-API, mit der Sie die Inhalte und Einstellungen eines Space erstellen, lesen, bearbeiten und löschen. Die Arbeiten, die Sie im Content-Studio erledigen (Inhalte verfassen, veröffentlichen, Mitglieder und Rollen verwalten, Token ausstellen usw.), können Sie genauso aus dem Code heraus ausführen. Die schreibgeschützte API, die veröffentlichte Inhalte an Besucher ausliefert, wird gesondert von der CDA übernommen.

Die Basis-URL lautet https://cma.weegloo.com/v1. Die aufrufende Identität ist ein Weegloo User (ein Weegloo-Plattformkonto). Auf Servern, in CI oder in Skripten senden Sie ein Personal Access Token, in Browser-Verwaltungsoberflächen das vom Content-Studio-Login-Ablauf ausgestellte Token als Bearer. Mit der ACMA, die mit der Identität eines am Produkt angemeldeten Mitglieds (ServiceUser) arbeitet, sind die Token nicht kompatibel.

Gemeinsames Verhalten

Das Folgende gilt für alle CMA-Ressourcen. Jede Ressourcenseite setzt dieses Verhalten voraus und behandelt nur ihre eigenen spezifischen Inhalte.

  • Vollständiges CRUD. Erstellen (POST), Abfragen (GET), Bearbeiten (PUT/PATCH) und Löschen (DELETE) werden alle unterstützt. Anders als bei der schreibgeschützten CDA finden das Schreiben und das Veröffentlichen hier statt.
  • Für Bearbeitungen ist ein Versions-Header erforderlich. Beim Bearbeiten einer Ressource müssen Sie im Header x-weegloo-version den aktuellen Wert von sys.version der Ressource mitgeben. Das verhindert, dass Sie eine Version überschreiben, die zuvor jemand anderes bearbeitet hat.
  • Teilweise Bearbeitung erfolgt per PATCH. Wenn Sie nur einzelne Felder ändern, senden Sie ein PATCH mit einem RFC 6902 JSON Patch als Body. Der Content-Type der Anfrage lautet dabei application/json-patch+json. Wenn Sie den gesamten Body ersetzen, verwenden Sie PUT.
  • Erst nach dem Veröffentlichen erfolgt die Auslieferung. Content, Media und Content Type müssen Sie in der CMA erstellen oder bearbeiten und anschließend veröffentlichen (Publish), damit sie an die CDA ausgeliefert werden. Draft-Stände oder unveröffentlichte Änderungen vor dem Veröffentlichen sind zwar im Content-Studio und in der CMA sichtbar, gelangen aber nicht auf den Auslieferungsweg.
  • Antwort-Medientyp. Der Content-Type der Antwort lautet application/vnd.com.weegloo.v1+json;charset=UTF-8. Wenn Sie in der Anfrage Accept: application/json senden, kann die Aushandlung fehlschlagen. Lassen Sie Accept daher weg oder verwenden Sie denselben Vendor-Typ.

Gemeinsame Konventionen wie die Parameter für Listenabfragen (limit, order, include, select, Filter, Cursor-Paginierung), der Aufbau von sys oder die Fehlercodes werden in Gemeinsame Query-Parameter, Systemeigenschaften (sys), Konventionen und Fehler behandelt.

Ressourcen

Inhalte

  • Content Type: Definiert die Vorlage (das Schema), der Inhalte folgen. Hier legen Sie Feldaufbau, Typ, Mehrsprachigkeit, Pflichtangabe und Validierungsregeln fest.
  • Content: Erstellt, bearbeitet und veröffentlicht einen einzelnen tatsächlichen Datensatz, der nach einem Content Type erzeugt wurde.
  • Media: Verwaltet die Ressource, die hochgeladene Dateien (Bilder, Dokumente usw.) aufnimmt.
  • Tag: Verwaltet kurze Labels, mit denen Content oder Media klassifiziert werden.
  • Locale: Verwaltet die vom Space unterstützten Spracheinstellungen (code, Standardkennzeichnung und fallbackCode).

Space und Organization, Berechtigungen

  • Organization: Das oberste Gefäß, das Space-Ressourcen aufnimmt. Der Abonnementplan (plan) und die Mitgliedschaften werden auf dieser Ebene verwaltet.
  • Organization Membership: Gibt an, mit welchen Berechtigungen eine Person zu welcher Organization gehört, und nimmt über eine E-Mail-Einladung neue Mitglieder auf.
  • Space: Der Arbeitsbereich, in dem alle Inhalte eines Projekts gesammelt werden.
  • Space Membership: Gibt an, mit welchen SpaceRole-Rollen ein Benutzer zu welchem Space gehört.
  • SpaceRole: Ein Bündel von Berechtigungen, das einem Mitglied eines Space zugewiesen wird. Es enthält die Aktionen je Ressource (Lesen, Erstellen, Bearbeiten, Löschen, Veröffentlichen) sowie Bereichsfilter.

Token

  • Personal Access Token: Ein langlebiges Token, das ein Weegloo User verwendet, um auf Servern, in CI oder in Skripten mit den eigenen Berechtigungen CMA, Upload und CDA aufzurufen.
  • Delivery Access Token: Ein Lese-Token, mit dem in der CDA veröffentlichte Inhalte gelesen werden. Bei der Ausstellung wird es an eine SpaceRole gebunden, die den Leseumfang festlegt.

Produktmitglieder (ServiceUser)

  • ServiceLogin: Die Einstellung, mit der ein Space die End-User (ServiceUser) des eigenen Produkts per OAuth registriert und anmeldet.
  • ServiceUserRole: Ein Bündel von Berechtigungen, das einem am Produkt angemeldeten ServiceUser zugewiesen wird. Es gilt für ACMA und ACDA.
  • ServiceUser: Ein über ServiceLogin registrierter End-User des Produkts, also ein Mitgliedskonto.

Bereitstellung und Anbindung

  • Web Hosting: Eine Ressource, die eine erstellte statische Website unter der Adresse {subdomain}.weegloo.app bereitstellt.
  • Webhook: Eine Einstellung, die bei einem Ereignis in einem Space (zum Beispiel beim Erstellen oder Veröffentlichen von Content) eine HTTP-Anfrage an eine festgelegte externe URL sendet.
  • CDA: Die schreibgeschützte API, die veröffentlichte Inhalte an Besucher ausliefert.
  • ACMA: Die Variante, die dieselben Management-Arbeiten mit der Identität eines Mitglieds (ServiceUser) durchführt.
  • Upload: Die Upload-API, die nach dem Hochladen einer Datei deren Ergebnis mit dem Erstellen von Media verknüpft.