Space
Space 是承载一个项目全部内容的工作空间。定义内容结构的 Content Type、作为实际数据的 Content、图片和文件之类的 Media、以及语言设置 Locale，都存放在同一个 Space 之中。一个 Space 隶属于上层容器 Organization，通常每个服务对应一个 Space。
要查询自己所属的 Space 列表，请使用 GET /me/space-memberships。
资源结构
下面是 Space“DailyWear 商城”单条查询的响应。它包含 sys（系统属性）和正文属性 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 商城"
}主要键：
name：Space 的名称（1-64 字符）。是项目或服务的显示名称。organization：指向该 Space 所属上层 Organization 的Refer<Organization>。
订阅套餐并不挂在 Space 上，而是挂在上层 Organization 上。要查看或变更套餐，请参见 Organization。
系统属性 (sys) 与正文
每个 Space 都在 sys 对象中包含通用系统属性。organization 为 Refer<Organization>，createdBy 和 updatedBy 采用 Refer 形态（{ "sys": { "id", "type": "Refer", "targetType" } }）。
| 属性 | 类型 | 说明 |
|---|---|---|
id | string | 资源唯一标识符。 |
type | string | 资源种类。Space 始终为 "Space"。 |
organization | Refer<Organization> | 该 Space 所属的上层 Organization。 |
createdBy | Refer<User> | 创建该资源的用户。 |
createdAt | string (date-time) | 创建时间。 |
updatedBy | Refer<User> | 最后修改该资源的用户。 |
updatedAt | string (date-time) | 最后修改时间。 |
version | integer (≥1) | 资源版本。每次修改时递增 1。 |
正文属性：
| 属性 | 类型 | 说明 |
|---|---|---|
name | string (1~64) | Space 名称。在创建和修改时指定。 |
description | string (1~128) | Space 说明。为可选项。 |
icon | string (读取) / object (写入) | Space 图标。在响应中为图片 URL 字符串。在修改请求中，以指向已上传文件的对象 { "upload": { "sys": { ..., "targetType": "Upload" } } } 发送（引用通过 Upload API 获取的 Upload）。 |
Space 是没有发布概念的设置类资源。因此与 Content 和 Media 不同，它的 sys 中没有 publish、archive、status，只有 version。每次修改 Space 时 version 都会递增。
把 Space 的主页更换为其他页面的设置不在该资源上，而在上层 Organization 上。在 Organization 中指定 consoleHomeUrl 之后，其下所有 Space 的主页都会变为该页面。
错误
以下是处理 Space 时会遇到的错误码。所有资源共通的错误码，请参见通用错误。
| 错误码 | 条件 |
|---|---|
WGL422024 | 试图删除内部仍留有 Content Type、Content、Media、Web Hosting 中任意一项的 Space。把剩下的这些资源全部删除之后，才能删除该 Space。 |
WGL422046 | 作为 icon 上传的文件超出了允许的大小。 |
WGL422047 | 作为 icon 上传的文件不是 PNG、JPG 或 WebP 格式。 |
API
下面所有端点的基准 URL 均为 https://cma.weegloo.com/v1，并且需要在 Authorization 头中提供用于 CMA 认证的 Bearer 令牌。修改和部分修改时，为实现乐观并发控制，必须一并发送 X-Weegloo-Version 头（当前资源的 sys.version）。创建和删除不需要此头。列表、创建、修改、部分修改、删除位于上层 Organization 路径（/organizations/{organizationId}/spaces）之下。单条查询可以像下面那样通过 /spaces/{spaceId} 直接路径进行（上层 Organization 路径 /organizations/{organizationId}/spaces/{spaceId} 也提供单条查询）。
相关文档
- Organization：该 Space 所属的上层 Organization。
- Space Membership：Space 成员与我所属的 Space 查询。
- Locale：Space 的语言设置。