Space
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" } },
"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: einRefer<Organization>, der auf die übergeordnete Organization verweist, zu der dieser Space gehört.
Der Abonnementtarif ist nicht an den Space gebunden, sondern an die übergeordnete Organization. Wenn Sie den Tarif prüfen oder wechseln möchten, lesen Sie Organization.
Systemeigenschaften (sys) und Inhalt
Jeder Space führt die gemeinsamen Systemeigenschaften im Objekt sys. organization ist ein Refer<Organization>, und createdBy sowie updatedBy haben die Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }).
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
id | string | Eindeutiger Bezeichner der Ressource. |
type | string | Ressourcenart. Bei einem Space immer "Space". |
organization | Refer<Organization> | Die übergeordnete Organization, zu der dieser Space gehört. |
createdBy | Refer<User> | Benutzer, der die Ressource erstellt hat. |
createdAt | string (date-time) | Zeitpunkt der Erstellung. |
updatedBy | Refer<User> | Benutzer, der die Ressource zuletzt geändert hat. |
updatedAt | string (date-time) | Zeitpunkt der letzten Änderung. |
version | integer (≥1) | Version der Ressource. Erhöht sich bei jeder Änderung um 1. |
Inhaltseigenschaften:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
name | string (1 bis 64) | Name des Space. Wird beim Erstellen und Ändern angegeben. |
description | string (1 bis 128) | Beschreibung des Space. Optionales Feld. |
icon | string (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.
Die Einstellung, mit der Sie die Startseite eines Space durch eine andere Seite ersetzen, liegt nicht auf dieser Ressource, sondern auf der übergeordneten Organization. Sobald Sie consoleHomeUrl der Organization angeben, wechselt die Startseite aller darunter liegenden Space zu dieser Seite.
Fehler
Dies sind die Codes, die beim Umgang mit einem Space auftreten. Codes, die allen Ressourcen gemeinsam sind, finden Sie unter Gemeinsame Fehler.
| Code | Bedingung |
|---|---|
WGL422024 | Der Aufrufer wollte einen Space löschen, obwohl darin noch Content Type, Content, Media oder Web Hosting vorhanden waren. Dieser Space lässt sich erst löschen, nachdem alles Verbliebene gelöscht wurde. |
WGL422046 | Die als icon hochgeladene Datei überschreitet die zulässige Größe. |
WGL422047 | Die als icon hochgeladene Datei ist keine PNG-, JPG- oder WebP-Datei. |
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}).
Verwandte Dokumente
- 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.
