Content Type

Content Type adalah kerangka (skema) yang diikuti oleh konten. Ia mendefinisikan field apa saja yang dimiliki, serta tipe, status multibahasa, status wajib, dan aturan validasi dari masing-masing field. Sebagai contoh "produk" pada sebuah toko pakaian daring, susunan item seperti nama produk, harga, deskripsi rinci, dan foto utama diatur oleh satu Content Type "Produk", dan tiap produk individual nyatanya dibuat sebagai Content yang mengikuti kerangka ini.

Pada CMA, Content Type merupakan sub-resource dari Space, dan jalurnya didasarkan pada /spaces/{spaceId}/content-types. Tugas pengelolaan seperti pembuatan, penyuntingan, dan pembatalan publikasi dilakukan di CMA, sedangkan snapshot yang sudah dipublikasikan dikirimkan ke CDA. Namun Content Type dipublikasikan secara otomatis saat dibuat atau disunting, sehingga berbeda dengan Content, ia langsung berstatus Published tanpa panggilan publikasi terpisah (lihat Status dan publikasi otomatis di bawah).

Struktur resource

Berikut adalah respons pengambilan tunggal untuk Content Type "Produk". Bersama dengan sys (properti sistem), ia memiliki properti badan seperti name, displayField, publishWithAuthor, dan fields.

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA",
    "type": "ContentType",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "publish": {
      "version": 7,
      "at": "2026-06-17T03:13:49.973Z",
      "firstAt": "2026-06-14T17:04:46.953Z",
      "counter": 4,
      "by": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } }
    },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T17:04:46.846Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-17T03:13:49.973Z",
    "version": 8,
    "status": "Published"
  },
  "name": "Produk",
  "displayField": "productName",
  "publishWithAuthor": false,
  "fields": [
    { "id": "5n06s7ocmwdi", "name": "Nama produk", "apiName": "productName", "type": "ShortText", "localized": true, "required": true, "validations": [], "disabled": false },
    { "id": "1gecyz8g4llwf", "name": "Harga", "apiName": "price", "type": "Long", "localized": false, "required": false, "validations": [], "disabled": false },
    { "id": "3ow4popgz54zg", "name": "Deskripsi", "apiName": "description", "type": "RichText", "localized": true, "required": false, "validations": [], "disabled": false },
    { "id": "2alxdptmdub1s", "name": "Foto", "apiName": "photo", "type": "Refer", "localized": false, "required": false, "validations": [], "disabled": false, "targetType": "Media" },
    {
      "id": "2a80lehazfx3t",
      "name": "Merek",
      "apiName": "brand",
      "type": "Refer",
      "localized": false,
      "required": false,
      "validations": [
        { "referContentType": [ { "sys": { "id": "3trmXRM3RqbgSnifyg7OveRYWnJWEG", "type": "Refer", "targetType": "ContentType" } } ] }
      ],
      "disabled": false,
      "targetType": "Content"
    }
  ]
}

Kunci utama:

• sys.id: Pengenal unik dari Content Type. Nilai ini masuk ke {contentTypeId} pada jalur pengambilan tunggal, penyuntingan, dan penghapusan.
• name: Nama dari Content Type (contoh: Produk).
• displayField: apiName dari field yang ditampilkan mewakili tiap Content di daftar studio konten (contoh: productName).
• publishWithAuthor: Menentukan apakah informasi penulis disertakan saat Content dipublikasikan. Nilai bawaannya adalah false.
• fields: Daftar field yang didefinisikan oleh kerangka ini. Struktur tiap item dijelaskan di Field di bawah.

Field photo memiliki type Refer dan targetType Media, sehingga menunjuk ke aset berkas yang diunggah. Field brand adalah Refer + targetType: Content, dan melalui referContentType pada validations ia dibatasi agar hanya merujuk ke Content dari Content Type tertentu (dalam hal ini "Merek").

Properti sistem (sys)

Setiap Content Type menempatkan properti sistem umum dan properti khusus Content Type di dalam objek sys. space, createdBy, dan updatedBy masuk dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Kunci dari objek publish:

Jika dibatalkan publikasinya (DELETE .../publish), version, at, dan by dihapus dari publish, dan hanya firstAt serta counter yang tersisa.

sys dari Content Type tidak memiliki properti contentType (referensi-diri) yang ada pada sys dari Content. Hal ini karena Content Type itu sendiri adalah kerangka. Properti archive juga tidak ada.

Field

fields adalah daftar field yang didefinisikan oleh Content Type ini. Setiap item memiliki struktur berikut (FieldDefinition).

Jenis field (type)

type menentukan cara nilai disimpan dan diambil. Sebagian tipe memiliki perilaku pencarian yang berbeda.

Pada contoh "Produk", Nama produk adalah ShortText, Harga adalah Long, Deskripsi adalah RichText, Foto adalah Refer (targetType: Media), dan Merek adalah Refer (targetType: Content).

Validasi (validations)

validations adalah array aturan yang diterapkan pada nilai field. Setiap item menampung salah satu dari kunci berikut.

Nilai yang dapat dipakai pada mediaMimetypeGroup (12 jenis): Attachment, Plaintext, Image, Audio, Video, RichText, Presentation, Spreadsheet, PdfDocument, Archive, Code, Markup.

Field brand pada contoh "Produk" dibatasi melalui referContentType agar hanya merujuk ke Content Type "Merek" (yang sys.id-nya 3trmXRM3RqbgSnifyg7OveRYWnJWEG).

Status dan publikasi otomatis

Content Type dipublikasikan secara otomatis saat pembuatan, penyuntingan, dan penyuntingan parsial. Hal ini berbeda dari Content. Content baru masuk ke jalur pengiriman setelah ada panggilan publikasi terpisah usai pembuatan, sedangkan Content Type langsung mengembalikan respons pembuatan dengan status: "Published".

status adalah salah satu dari 4 berikut.

sys.version bertambah 1 pada setiap perubahan. Karena pada Content Type penyuntingan dan publikasi terjadi sekaligus, satu kali penyuntingan menaikkan version sebesar 2 (penyuntingan itu sendiri +1, publikasi otomatis +1). Pada contoh "Pengumuman", tepat setelah pembuatan version adalah 2 (pembuatan +1, publikasi otomatis +1) dan publish.counter adalah 1. Selanjutnya jika disunting, version menjadi 4 dan publish.counter menjadi 2.

Satu-satunya jalur agar Content Type menjadi Draft adalah pembatalan publikasi secara eksplisit (DELETE .../publish). Jika dibatalkan publikasinya, status menjadi Draft, dan pada objek publish version, at, dan by dihilangkan sementara hanya firstAt dan counter yang tersisa.

Batasan

Pengaman penghapusan: Penghapusan harus memenuhi kedua syarat berikut.

• Jika ada setidaknya satu Content yang memakai Content Type ini, ia tidak dapat dihapus (WGL422010). Hapus dulu semua Content terkait. Pemeriksaan ini terkena lebih dahulu.
• Content Type yang berstatus publikasi (Published, Changed) tidak dapat langsung dihapus (WGL422009). Batalkan dulu publikasinya (DELETE .../publish) untuk membuatnya Draft, lalu hapus (status Archived juga dapat dihapus).

API

URL dasar untuk semua endpoint di bawah adalah https://cma.weegloo.com/v1, dan diperlukan token Bearer yang mengautentikasi CMA pada header Authorization. Penyuntingan, penyuntingan parsial, publikasi, dan pembatalan publikasi harus disertai header X-Weegloo-Version (sys.version resource saat ini) untuk kendali konkurensi optimistis.

Dokumen terkait

• Pemodelan Content: Cara membuat Content Type di studio konten.
• Status dan publikasi: Arti dari publikasi dan versi.