Space
最后更新：2026年6月22日
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" } },
"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 商城"
}主要键：
name：Space 的名称（1-64 字符）。是项目或服务的显示名称。organization：指向该 Space 所属上层 Organization 的Refer<Organization>。plan：指向该 Space 订阅套餐的Refer<Plan>（例如free）。
系统属性 (sys) 与正文
每个 Space 都在 sys 对象中包含通用系统属性。organization 为 Refer<Organization>，plan 为 Refer<Plan>，createdBy 和 updatedBy 采用 Refer 形态（{ "sys": { "id", "type": "Refer", "targetType" } }）。
| 属性 | 类型 | 说明 |
|---|---|---|
id | string | 资源唯一标识符。 |
type | string | 资源种类。Space 始终为 "Space"。 |
organization | Refer<Organization> | 该 Space 所属的上层 Organization。 |
plan | Refer<Plan> | 订阅套餐。例如 free。 |
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 都会递增。
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 的语言设置。