Space Membership

Space Membership adalah catatan yang menunjukkan seorang pengguna termasuk dalam Space mana dan dengan SpaceRole apa saja. Satu pengguna dapat termasuk dalam beberapa Space, dan izinnya dapat berbeda di setiap Space, sehingga satu kombinasi pengguna, Space, dan izin sesuai dengan satu Space Membership. Berbeda dengan Organization Membership yang menambahkan orang baru dengan mengundang melalui email, Space Membership menambahkan pengguna yang sudah ada melalui referensi user dan memberikan izin melalui roles (array referensi SpaceRole). Ini bukan undangan email.

Daftar Space yang Anda ikuti dapat diperiksa melalui GET /me/space-memberships. Jika Anda menyertakan include=1, detail Space yang dirujuk juga akan disertakan dalam respons.

Struktur sumber daya

Berikut adalah respons pengambilan tunggal dari satu Space Membership. Pada sys (properti sistem) terdapat pengguna (user) dan Space (space) yang dirujuk oleh keanggotaan ini, dan sebagai properti badan terdapat kumpulan izin (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" } }
  ]
}

Kunci utama:

• space: Refer<Space> yang merujuk ke Space tempat keanggotaan ini berada.
• user: Refer<User> yang merujuk ke pengguna dari keanggotaan ini. Pengguna yang ditambahkan sebagai anggota terikat di sini.
• roles: kumpulan izin yang dimiliki pengguna ini di Space. Berupa array Refer<SpaceRole> yang merujuk ke SpaceRole, dan satu anggota dapat memiliki beberapa SpaceRole sekaligus.

Properti sistem (sys) dan badan

Setiap Space Membership menampung properti sistem bersama di dalam objek sys. space, user, createdBy, dan updatedBy masuk dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Properti badan:

Space Membership adalah sumber daya pengaturan yang tidak memiliki konsep publikasi. Karena itu, berbeda dengan Content dan Media, sys tidak memiliki publish, archive, atau status, dan hanya memiliki version. version naik setiap kali keanggotaan diubah.

API

Base URL untuk semua endpoint di bawah ini adalah https://cma.weegloo.com/v1, dan header Authorization memerlukan token Bearer yang mengautentikasi CMA. Untuk perubahan peran (PUT, PATCH), Anda harus menyertakan header X-Weegloo-Version (sys.version sumber daya saat ini) untuk kontrol konkurensi optimistis. Penambahan anggota (pembuatan) dan penghapusan tidak memerlukan header ini.

Dokumen terkait

• SpaceRole: definisi SpaceRole (kumpulan izin) yang dimasukkan ke roles.
• Space: Space tempat keanggotaan ini berada.
• Organization Membership: anggota dan peran pada tingkat Organization.