Organization

Terakhir diperbarui: 22 Juni 2026

Organization adalah wadah tingkat tertinggi yang menampung Space. Satu perusahaan atau tim setara dengan satu Organization, dan di bawahnya ditempatkan beberapa Space. Karena paket langganan (plan) dan keanggotaan dikelola pada tingkat Organization, penagihan dan hak akses anggota diterapkan berdasarkan Organization ini, bukan Space.

Daftar Organization yang Anda ikuti diperoleh melalui GET /me/organization-memberships. Resource ini tidak memiliki endpoint yang mengembalikan seluruh daftar.

Struktur resource

Berikut adalah respons pengambilan tunggal untuk Organization "Perusahaan DailyWear". Resource ini memiliki sys (properti sistem) serta properti isi name dan description.

{
  "sys": {
    "id": "ilLRJxDp",
    "type": "Organization",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.832Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.832Z",
    "version": 1,
    "isOfficial": false,
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } }
  },
  "name": "Perusahaan DailyWear",
  "description": "Perusahaan yang menjalankan toko online pakaian dan aksesori"
}

Kunci utama:

  • name: nama Organization (1 hingga 64 karakter). Nama tampilan perusahaan atau tim.
  • description: keterangan tentang Organization (1 hingga 128 karakter, opsional).
  • plan: Refer<Plan> yang menunjuk paket langganan Organization ini (misalnya free). Paket penagihan terikat di sini.
  • isOfficial: apakah ini Organization resmi (boolean).

Properti sistem (sys) dan isi

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

PropertiTipeKeterangan
idstringPengenal unik resource.
typestringJenis resource. Untuk Organization selalu "Organization".
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.
isOfficialbooleanApakah Organization resmi.
planRefer<Plan>Paket langganan. Misalnya free.

Properti isi:

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

Organization 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 Organization diubah.

API

Base URL untuk semua endpoint di bawah ini adalah https://cma.weegloo.com/v1, dan header Authorization memerlukan Bearer token yang mengautentikasi ke CMA. Untuk perubahan dan perubahan sebagian, header X-Weegloo-Version (yaitu sys.version resource saat ini) harus disertakan demi kontrol konkurensi optimis. Pembuatan dan penghapusan tidak menggunakan header ini.