Space

Space adalah ruang kerja tempat semua konten satu proyek disimpan. Content Type yang mendefinisikan struktur konten, Content yang merupakan data sesungguhnya, Media seperti gambar dan berkas, serta Locale yang merupakan pengaturan bahasa, semuanya berada di dalam satu Space. Satu Space termasuk di bawah Organization sebagai wadah induknya, dan biasanya satu layanan memiliki satu Space.

Daftar Space tempat Anda menjadi anggota dapat dilihat melalui GET /me/space-memberships.

Struktur resource

Berikut adalah respons pengambilan tunggal untuk Space "Toko DailyWear". Space memiliki sys (properti sistem) dan properti badan 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": "Toko DailyWear"
}

Kunci utama:

  • name: nama Space (1 sampai 64 karakter). Nama tampilan proyek atau layanan.
  • organization: Refer<Organization> yang menunjuk ke Organization induk tempat Space ini berada.

Paket langganan terikat pada Organization induk, bukan pada Space. Untuk memeriksa atau mengubah paket langganan, lihat Organization.

Properti sistem (sys) dan badan

Setiap Space menyimpan properti sistem umum di objek sys. organization berupa Refer<Organization>, sedangkan createdBy dan updatedBy masuk dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

PropertiTipeDeskripsi
idstringPengenal unik resource.
typestringJenis resource. Space selalu "Space".
organizationRefer<Organization>Organization induk tempat Space ini berada.
createdByRefer<User>Pengguna yang membuat.
createdAtstring (date-time)Waktu pembuatan.
updatedByRefer<User>Pengguna yang terakhir mengubah.
updatedAtstring (date-time)Waktu perubahan terakhir.
versioninteger (≥1)Versi resource. Naik 1 setiap kali diubah.

Properti badan:

PropertiTipeDeskripsi
namestring (1 sampai 64)Nama Space. Ditentukan saat pembuatan dan perubahan.
descriptionstring (1 sampai 128)Deskripsi Space. Bersifat opsional.
iconstring (baca) / object (tulis)Ikon Space. Pada respons berupa string URL gambar. Pada permintaan perubahan dikirim sebagai objek yang menunjuk berkas yang telah diunggah, yaitu { "upload": { "sys": { ..., "targetType": "Upload" } } } (referensi Upload yang diperoleh melalui Upload API).

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

Pengaturan untuk mengganti layar beranda Space dengan halaman lain tidak berada pada resource ini, melainkan pada Organization induk. Jika Anda menentukan consoleHomeUrl pada Organization, layar beranda semua Space di bawahnya berubah menjadi halaman tersebut.

Error

Berikut adalah kode yang muncul saat Anda menangani Space. Untuk kode yang berlaku umum pada semua resource, lihat Error umum.

KodeKondisi
WGL422024Anda mencoba menghapus Space padahal di dalam Space tersebut masih ada salah satu dari Content Type, Content, Media, atau Web Hosting. Anda baru dapat menghapus Space tersebut setelah semua sisa itu dihapus.
WGL422046Berkas yang Anda unggah sebagai icon melampaui ukuran yang diizinkan.
WGL422047Berkas yang Anda unggah sebagai icon bukan PNG, JPG, atau WebP.

API

URL dasar untuk semua endpoint di bawah ini adalah https://cma.weegloo.com/v1, dan diperlukan token Bearer untuk autentikasi CMA pada header Authorization. Untuk perubahan dan perubahan sebagian, Anda harus menyertakan header X-Weegloo-Version (yaitu sys.version resource saat ini) untuk kontrol konkurensi optimistis. Pembuatan dan penghapusan tidak memiliki header ini. Daftar, pembuatan, perubahan, perubahan sebagian, dan penghapusan berada di bawah jalur Organization induk (/organizations/{organizationId}/spaces). Pengambilan tunggal dapat dilakukan melalui jalur langsung /spaces/{spaceId} seperti di bawah ini (pengambilan tunggal juga tersedia pada jalur Organization induk /organizations/{organizationId}/spaces/{spaceId}).

  • Organization: Organization induk tempat Space ini berada.
  • Space Membership: Anggota Space dan pengambilan Space tempat saya menjadi anggota.
  • Locale: Pengaturan bahasa dari Space.