CMA (Content Management API)

Terakhir diperbarui: 3 Juli 2026

CMA (Content Management API) adalah API manajemen untuk membuat, membaca, menyunting, dan menghapus konten serta pengaturan sebuah Space. Pekerjaan yang biasa Anda lakukan di studio konten (menyusun konten, mempublikasikan, mengelola anggota dan peran, menerbitkan token, dan sebagainya) dapat dilakukan langsung dari kode dengan cara yang sama. API baca-saja yang mengirimkan konten yang sudah dipublikasikan kepada pengunjung ditangani secara terpisah oleh CDA.

Base URL-nya adalah https://cma.weegloo.com/v1. Identitas pemanggilnya adalah Weegloo User (akun platform Weegloo). Pada server, CI, atau skrip, kirim Personal Access Token sebagai Bearer; pada UI admin di browser, kirim token yang diterbitkan oleh alur login studio konten. Token ini tidak kompatibel dengan ACMA yang bekerja dengan identitas anggota produk (ServiceUser).

Perilaku umum

Berikut ini berlaku untuk seluruh resource CMA. Setiap halaman resource mengasumsikan perilaku ini dan hanya membahas isi khasnya sendiri.

  • CRUD penuh. Mendukung pembuatan (POST), pembacaan (GET), penyuntingan (PUT/PATCH), dan penghapusan (DELETE). Berbeda dari CDA yang baca-saja, penulisan dan publikasi terjadi di sini.
  • Penyuntingan memerlukan header versi. Saat menyunting sebuah resource, Anda harus menyertakan nilai sys.version resource saat ini pada header x-weegloo-version. Ini adalah pengaman agar Anda tidak menimpa versi yang sudah lebih dulu diubah orang lain.
  • Penyuntingan sebagian dengan PATCH. Saat mengubah hanya sebagian field, kirim PATCH dengan body RFC 6902 JSON Patch. Dalam hal ini Content-Type permintaan adalah application/json-patch+json. Saat mengganti dengan body utuh, gunakan PUT.
  • Harus dipublikasikan agar dikirim. Content, Media, dan Content Type dikirim ke CDA hanya setelah dibuat atau diubah di CMA lalu dipublikasikan (Publish). Draft sebelum publikasi atau perubahan yang belum dipublikasikan tetap terlihat di studio konten dan CMA, tetapi tidak masuk ke jalur pengiriman.
  • Media type respons. Content-Type respons adalah application/vnd.com.weegloo.v1+json;charset=UTF-8. Jika Anda mengirim Accept: application/json pada permintaan, negosiasi bisa gagal, jadi hilangkan Accept atau gunakan vendor type yang sama.

Konvensi umum seperti parameter pembacaan daftar (limit, order, include, select, filter, paginasi berbasis kursor), struktur sys, dan kode error dibahas di Parameter kueri umum, Properti sistem (sys), Konvensi, dan Error.

Resource

Konten

  • Content Type: Mendefinisikan kerangka (skema) yang diikuti konten. Menentukan susunan field, tipe, status multibahasa, status wajib, dan aturan validasi.
  • Content: Membuat, menyunting, dan mempublikasikan satu data nyata yang dicetak dari sebuah Content Type.
  • Media: Mengelola resource yang menampung file yang diunggah (gambar, dokumen, dan sebagainya).
  • Tag: Mengelola label pendek yang mengklasifikasikan Content atau Media.
  • Locale: Mengelola pengaturan bahasa yang didukung Space (code, status default, fallbackCode).

Ruang dan organisasi, perizinan

  • Organization: Wadah tingkat tertinggi yang menampung Space. Paket langganan (plan) dan keanggotaan dikelola pada tingkat ini.
  • Organization Membership: Menunjukkan seseorang termasuk dalam Organization mana dengan izin apa, dan menambahkan anggota baru lewat undangan email.
  • Space: Ruang kerja tempat seluruh konten satu proyek ditampung.
  • Space Membership: Menunjukkan seorang pengguna termasuk dalam Space mana dengan SpaceRole apa saja.
  • SpaceRole: Kumpulan izin yang diberikan kepada anggota Space. Memuat tindakan per resource (membaca, membuat, menyunting, menghapus, mempublikasikan) dan filter cakupan.

Token

  • Personal Access Token: Token jangka panjang yang dipakai Weegloo User untuk memanggil CMA, Upload, dan CDA dengan izinnya sendiri dari server, CI, atau skrip.
  • Delivery Access Token: Token baca yang dipakai untuk membaca konten yang sudah dipublikasikan di CDA. Saat diterbitkan, ia diikat ke satu SpaceRole untuk menentukan cakupan pembacaan.

Anggota produk (ServiceUser)

  • ServiceLogin: Pengaturan agar Space mendaftarkan dan menyandikan masuk end-user produknya sendiri (ServiceUser) lewat OAuth.
  • ServiceUserRole: Kumpulan izin yang diberikan kepada ServiceUser yang mendaftar ke produk. Berlaku untuk ACMA/ACDA.
  • ServiceUser: End-user produk yang mendaftar lewat ServiceLogin, yaitu akun anggota.

Penyebaran dan integrasi

  • Web Hosting: Resource yang menyajikan situs web statis hasil build pada alamat {subdomain}.weegloo.app.
  • Webhook: Pengaturan untuk mengirim permintaan HTTP ke URL eksternal yang ditentukan saat suatu peristiwa terjadi di Space (misalnya pembuatan atau publikasi Content).
  • CDA: API baca-saja yang mengirimkan konten yang sudah dipublikasikan kepada pengunjung.
  • ACMA: Versi yang melakukan pekerjaan manajemen yang sama dengan identitas anggota (ServiceUser).
  • Upload: API unggah yang menyambungkan hasil unggahan file ke pembuatan Media.