Space

Zuletzt aktualisiert: 22. Juni 2026

Ein Space ist der Arbeitsbereich, in dem die gesamten Inhalte eines Projekts liegen. Der Content Type, der die Inhaltsstruktur definiert, die eigentlichen Daten in Form von Content, Media wie Bilder und Dateien sowie die Spracheinstellung Locale leben alle innerhalb eines einzigen Space. Ein Space gehört zu einer übergeordneten Organization als Containerebene; üblicherweise wird pro Dienst ein Space angelegt.

Die Liste der Space, denen Sie angehören, rufen Sie über GET /me/space-memberships ab.

Ressourcenstruktur

Im Folgenden sehen Sie die Einzelabfrage-Antwort für den Space "DailyWear Shop". Er besitzt sys (Systemeigenschaften) und die Inhaltseigenschaft name.

{
  "sys": {
    "id": "HnQ32YiH",
    "type": "Space",
    "organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T14:56:04.737Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-14T14:56:58.670Z",
    "version": 2
  },
  "name": "DailyWear Shop"
}

Wichtige Schlüssel:

  • name: der Name des Space (1 bis 64 Zeichen). Der Anzeigename des Projekts oder Dienstes.
  • organization: ein Refer<Organization>, der auf die übergeordnete Organization verweist, zu der dieser Space gehört.
  • plan: ein Refer<Plan>, der auf das Abonnement-Tarif dieses Space verweist (z. B. free).

Systemeigenschaften (sys) und Inhalt

Jeder Space führt die gemeinsamen Systemeigenschaften im Objekt sys. organization ist ein Refer<Organization>, plan ein Refer<Plan>, und createdBy sowie updatedBy haben die Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }).

EigenschaftTypBeschreibung
idstringEindeutiger Bezeichner der Ressource.
typestringRessourcenart. Bei einem Space immer "Space".
organizationRefer<Organization>Die übergeordnete Organization, zu der dieser Space gehört.
planRefer<Plan>Abonnement-Tarif. Beispiel: free.
createdByRefer<User>Benutzer, der die Ressource erstellt hat.
createdAtstring (date-time)Zeitpunkt der Erstellung.
updatedByRefer<User>Benutzer, der die Ressource zuletzt geändert hat.
updatedAtstring (date-time)Zeitpunkt der letzten Änderung.
versioninteger (≥1)Version der Ressource. Erhöht sich bei jeder Änderung um 1.

Inhaltseigenschaften:

EigenschaftTypBeschreibung
namestring (1 bis 64)Name des Space. Wird beim Erstellen und Ändern angegeben.
descriptionstring (1 bis 128)Beschreibung des Space. Optionales Feld.
iconstring (Lesen) / object (Schreiben)Symbol des Space. In der Antwort ist es eine Bild-URL als Zeichenkette. In der Änderungsanfrage senden Sie es als Objekt { "upload": { "sys": { ..., "targetType": "Upload" } } }, das auf die hochgeladene Datei verweist (Verweis auf ein Upload, das über die Upload API erhalten wurde).

Ein Space ist eine Konfigurationsressource ohne Veröffentlichungskonzept. Anders als Content und Media hat er in sys daher kein publish, archive oder status, sondern nur version. version erhöht sich bei jeder Änderung des Space.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Authorization-Header wird ein Bearer-Token benötigt, das CMA authentifiziert. Bei Änderung und Teiländerung muss zur optimistischen Nebenläufigkeitskontrolle der Header X-Weegloo-Version (das sys.version der aktuellen Ressource) mitgesendet werden. Bei Erstellung und Löschung entfällt dieser Header. Auflisten, Erstellen, Ändern, Teiländern und Löschen liegen unter dem Pfad der übergeordneten Organization (/organizations/{organizationId}/spaces). Die Einzelabfrage ist wie unten über den direkten Pfad /spaces/{spaceId} möglich (eine Einzelabfrage gibt es auch unter dem Pfad der übergeordneten Organization /organizations/{organizationId}/spaces/{spaceId}).

  • Organization: die übergeordnete Organization, zu der dieser Space gehört.
  • Space Membership: Mitglieder eines Space und Abfrage der Space, denen ich angehöre.
  • Locale: Spracheinstellung eines Space.