Tag

Terakhir diperbarui: 22 Juni 2026

Tag adalah label singkat untuk mengklasifikasikan Content atau Media. Sebagai contoh toko pakaian online, label seperti "Terlaris", "Produk baru" adalah Tag. Jika Tag yang sama dipasang pada beberapa Content dan Media, Anda nantinya dapat menelusuri atau menyaringnya berdasarkan label tersebut.

Tag sendiri adalah label yang hanya memiliki nama (name), dan merupakan resource pengaturan tanpa konsep publikasi. Memasangkannya ke sesuatu tidak dilakukan dengan mengubah Tag secara langsung, melainkan dengan memasukkan Refer dari Tag ini ke dalam metadata.tags milik Content atau Media (lihat Memasang tag pada konten dan media di bawah). Di CMA, Tag adalah resource turunan dari Space, dan jalurnya mengacu pada /spaces/{spaceId}/tags.

Struktur resource

Berikut adalah respons pengambilan tunggal Tag "Terlaris". Ia memiliki sys (properti sistem) dan properti isi name.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh",
    "type": "Tag",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-16T01:46:07.426Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-16T01:46:07.426Z",
    "version": 1
  },
  "name": "Terlaris"
}

Kunci utama:

  • sys.id: Pengidentifikasi unik Tag. Masuk ke {tagId} pada jalur pengambilan tunggal, perubahan, dan penghapusan, serta dipakai sebagai id target Refer saat memasang tag melalui metadata.tags.
  • name: Nama Tag (1~16 karakter). Label itu sendiri yang tampil pada klasifikasi konten.

Properti sistem (sys)

Setiap Tag menyimpan properti sistem umum dalam objek sys. space, createdBy, dan updatedBy masuk dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

PropertiTipeDeskripsi
idstringPengidentifikasi unik resource.
typestringJenis resource. Tag selalu "Tag".
spaceRefer<Space>Space tempat Tag 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 isi:

PropertiTipeDeskripsi
namestring (1~16)Nama Tag. Ditentukan saat pembuatan dan perubahan.

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

Memasang tag pada konten dan media

Untuk memasang Tag, lakukan dua langkah.

  1. Buat Tag (endpoint Buat Tag di bawah). Simpan sys.id dari respons.
  2. Saat membuat atau mengubah Content atau Media, masukkan Refer dari Tag ini ke dalam array metadata.tags pada isinya.

Bentuk Refer yang dimasukkan ke metadata.tags adalah sebagai berikut. Pada id, masukkan sys.id dari Tag yang diperoleh pada langkah 1.

"metadata": {
  "tags": [
    { "sys": { "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh", "type": "Refer", "targetType": "Tag" } }
  ]
}

Untuk memasang beberapa Tag, masukkan beberapa objek Refer ini ke dalam array. Untuk melepas tag, keluarkan item terkait dari array lalu ubah kembali Content atau Media tersebut. Untuk cara terperinci menyusun data isi Content dan Media, lihat dokumen Content dan Media.

API

URL dasar untuk semua endpoint di bawah adalah https://cma.weegloo.com/v1, dan diperlukan token Bearer yang mengautentikasi CMA pada header Authorization. Untuk perubahan dan perubahan parsial, header X-Weegloo-Version (sys.version resource saat ini) harus dikirim bersamaan untuk kontrol konkurensi optimistik. Pembuatan dan penghapusan tidak memerlukan header ini.

  • Content: Data isi yang memasang Tag melalui metadata.tags.
  • Media: Resource file yang memasang Tag melalui metadata.tags.