Space Membership

Space Membership 是一条记录，表示某个用户以哪些 SpaceRole 隶属于某个 Space。一个用户可以隶属于多个 Space，而且在每个 Space 中的权限可能不同，因此用户、Space 与权限的每一种组合都对应一个 Space Membership。与 Organization Membership 通过邮箱邀请加入新成员不同，Space Membership 通过 user 引用添加已存在的用户，并以 roles（SpaceRole 引用数组）授予权限。它不是邮箱邀请。

通过 GET /me/space-memberships 查询我所隶属的 Space 列表。同时发送 include=1 时，响应中会一并包含所指向的 Space 详情。

资源结构

下面是某一个 Space Membership 的单条查询响应。sys（系统属性）中包含此成员关系指向的用户（user）和 Space（space），主体属性中则持有权限集合（roles）。

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoWfVunfJ8uV",
    "type": "SpaceMembership",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "user": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "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:04.737Z",
    "version": 1
  },
  "roles": [
    { "sys": { "id": "3trmXRLdJF4GBlAjtcuoWfVubsasp4", "type": "Refer", "targetType": "SpaceRole" } }
  ]
}

主要键：

• space：指向此成员关系所属 Space 的 Refer<Space>。
• user：指向此成员关系用户的 Refer<User>。被添加为成员的用户绑定在这里。
• roles：此用户在 Space 中拥有的权限集合。它是指向 SpaceRole 的 Refer<SpaceRole> 数组，一个成员可以同时拥有多个 SpaceRole。

系统属性 (sys) 与主体

每个 Space Membership 都将公共系统属性放在 sys 对象中。space、user、createdBy、updatedBy 以 Refer 形式（{ "sys": { "id", "type": "Refer", "targetType" } }）出现。

主体属性：

Space Membership 是没有发布概念的设置类资源。因此与 Content、Media 不同，它的 sys 中没有 publish、archive、status，只有 version。每次修改成员关系时 version 都会递增。

API

以下所有端点的基础 URL 为 https://cma.weegloo.com/v1，并且需要在 Authorization 头中提供用于 CMA 认证的 Bearer 令牌。角色修改（PUT、PATCH）需要为了乐观并发控制而一并发送 X-Weegloo-Version 头（当前资源的 sys.version）。添加成员（创建）与删除不需要此头。

相关文档

• SpaceRole：放入 roles 的 SpaceRole（权限集合）的定义。
• Space：此成员关系所属的 Space。
• Organization Membership：以 Organization 为单位的成员与角色。