ServiceUser

ServiceUser adalah end-user produk yang mendaftar melalui ServiceLogin, yaitu akun anggota. Identitasnya terpisah dari akun platform Weegloo (Weegloo User yang masuk ke studio konten), dan token ServiceUser diautentikasi terhadap ACMA/ACDA.

ServiceUser dibuat saat anggota mendaftar sendiri melalui ServiceLogin. Karena itu API ini tidak memiliki endpoint pembuatan, hanya pengambilan data dan sebagian penyuntingan oleh administrator (Weegloo User).

Struktur resource

Berikut adalah respons pengambilan tunggal untuk satu ServiceUser. Selain sys (properti sistem), resource ini memiliki properti isi nickname, avatarUrl, roleOverride, dan enableLogin yang menyimpan informasi tampilan anggota dan pengaturan izin.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PSusr01Ex",
    "type": "ServiceUser",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "provider": "google",
    "email": "buyer@example.com",
    "createdAt": "2026-06-18T12:50:00.000Z",
    "updatedAt": "2026-06-18T12:50:00.000Z"
  },
  "nickname": "Pelanggan setia",
  "avatarUrl": "https://lh3.example.com/a/buyer-avatar",
  "roleOverride": null,
  "enableLogin": true
}

Kunci utama:

• sys.email: alamat email yang dipakai anggota untuk mendaftar. Bersama sys.provider, menunjukkan dengan akun apa anggota tersebut mendaftar.
• sys.provider: penyedia OAuth yang dipakai untuk mendaftar (misalnya google).
• roleOverride: Refer yang diisi saat memberikan ServiceUserRole berbeda hanya kepada anggota ini. Jika kosong (null), anggota mengikuti peran bawaan dari ServiceLogin.

Properti sistem (sys)

Setiap ServiceUser menyimpan properti sistem umum di objek sys. space masuk dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Karena ServiceUser adalah resource yang dibuat anggota melalui pendaftarannya sendiri, berbeda dari resource CMA lain, sys tidak memiliki createdBy, updatedBy, atau version. Karena tidak ada version, penyuntingan (PUT, PATCH) juga tidak mengirim header X-Weegloo-Version. Tidak ada konsep publikasi, sehingga tidak ada publish, archive, maupun status.

Properti isi

Pengelolaan anggota

ServiceUser terbentuk melalui pendaftaran. Yang dapat disesuaikan administrator (Weegloo User) melalui penyuntingan (PUT, PATCH) adalah dua hal berikut.

• Menentukan/melepas roleOverride: memberikan ServiceUserRole berbeda hanya kepada anggota tertentu. Dipakai saat memperlakukan satu anggota secara berbeda, seperti tingkatan berbayar, moderator, atau grup beta. roleOverride yang ditentukan lebih diutamakan daripada defaultRole dari ServiceLogin.
• Mengalihkan enableLogin: jika dimatikan, login anggota tersebut diblokir.

Mengeluarkan anggota dari daftar dilakukan di Content Studio. Langkah-langkahnya dan apa saja yang ikut hilang dibahas di Mengelola anggota layanan.

Untuk membuat satu anggota dapat menangani juga resource yang dibuat anggota lain, buatlah ServiceUserRole tersendiri yang memuat izin tersebut, lalu tetapkan pada roleOverride anggota itu. Apa saja yang dapat diakses seorang anggota ditentukan oleh ServiceUserRole yang berlaku baginya. Jika filter createdBy pada aturan disetel ke :self, tindakan itu hanya menyasar apa yang dibuatnya sendiri; jika filter tidak dipasang, tindakan itu turut menyasar apa yang dibuat anggota lain. Cara membuat kedua peran secara terpisah dibahas di ServiceUserRole.

API

Base URL untuk semua endpoint di bawah ini adalah https://cma.weegloo.com/v1, dan diperlukan token Bearer yang mengautentikasi CMA pada header Authorization. Karena ServiceUser adalah resource tanpa version, penyuntingan (PUT, PATCH) juga tidak mengirim header X-Weegloo-Version. Tidak ada endpoint pembuatan (dibuat melalui pendaftaran).

Ketika menyaring pengambilan daftar dengan sys.email, gunakan hanya operator keluarga kecocokan persis (eq·ne·in·nin). Alamat anggota disimpan terenkripsi, sehingga di atas representasi itu hanya dapat dinilai sama atau tidak sama; prefix maupun perbandingan urutan akan mengembalikan 0 hasil tanpa error. Jika Anda mencari anggota berdasarkan alamat tetapi hasilnya kosong, periksa operatornya terlebih dahulu. Pencarian dengan sebagian alamat tidak dapat digantikan oleh filter ini.

Dokumen terkait

• ServiceUserRole: kumpulan izin yang diberikan ke roleOverride.
• ServiceLogin: pengaturan pendaftaran anggota dan peran bawaan (defaultRole).
• Ikhtisar ACMA/ACDA: API yang dipanggil ServiceUser.
• Membaca direktori anggota pada Script: cara menemukan anggota lewat id atau email di dalam Script, beserta batasannya.