Tag

최종 수정: 2026년 6월 22일

Tag는 Content나 Media를 분류하는 짧은 라벨입니다. 옷가게 쇼핑몰을 예로 들면 "베스트셀러", "신상품" 같은 라벨이 Tag입니다. 같은 Tag를 여러 Content·Media에 달아 두면, 나중에 그 라벨로 묶어서 조회하거나 골라낼 수 있습니다.

Tag 자체는 이름(name)만 가진 라벨이며, 발행 개념이 없는 설정 리소스입니다. 실제로 무언가에 다는 것은 Tag를 직접 수정하는 것이 아니라, Content·Media의 metadata.tags에 이 Tag의 Refer를 넣어서 합니다(아래 콘텐츠·미디어에 태그 달기 참조). CMA에서 Tag는 Space 하위 리소스이며, 경로는 /spaces/{spaceId}/tags를 기준으로 합니다.

리소스 구조

다음은 Tag "베스트셀러"의 단일 조회 응답입니다. sys(시스템 속성)와 본문 속성 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": "베스트셀러"
}

주요 키:

  • sys.id: Tag의 고유 식별자입니다. 단일 조회·수정·삭제 경로의 {tagId}에 들어가며, metadata.tags로 태그를 달 때 Refer의 대상 id로도 씁니다.
  • name: Tag의 이름입니다(1~16자). 콘텐츠 분류에 보이는 라벨 그 자체입니다.

시스템 속성 (sys)

모든 Tag는 공통 시스템 속성을 sys 객체에 담습니다. space, createdBy, updatedBy는 Refer 모양({ "sys": { "id", "type": "Refer", "targetType" } })으로 들어갑니다.

속성타입설명
idstring리소스 고유 식별자.
typestring리소스 종류. Tag는 항상 "Tag".
spaceRefer<Space>이 Tag가 속한 Space.
createdByRefer<User>생성한 사용자.
createdAtstring (date-time)생성 시각.
updatedByRefer<User>마지막으로 수정한 사용자.
updatedAtstring (date-time)마지막 수정 시각.
versioninteger (≥1)리소스 버전. 수정할 때마다 1씩 올라갑니다.

본문 속성:

속성타입설명
namestring (1~16)Tag 이름. 생성·수정 시 지정합니다.

Tag는 발행 개념이 없는 설정 리소스입니다. 그래서 Content·Media와 달리 sys에 publish·archive·status가 없고, version만 가집니다. version은 Tag를 수정할 때마다 오릅니다.

콘텐츠·미디어에 태그 달기

Tag를 달려면 두 단계를 거칩니다.

  1. Tag를 만듭니다(아래 Tag 생성 엔드포인트). 응답의 sys.id를 받아 둡니다.
  2. Content·Media를 만들거나 고칠 때, 그 본문의 metadata.tags 배열에 이 Tag의 Refer를 넣습니다.

metadata.tags에 넣는 Refer의 모양은 다음과 같습니다. id에는 1단계에서 받은 Tag의 sys.id를 넣습니다.

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

여러 Tag를 달려면 이 Refer 객체를 배열에 여러 개 넣습니다. 태그를 떼려면 해당 항목을 배열에서 빼고 Content·Media를 다시 수정합니다. Content·Media 본문 데이터를 작성하는 자세한 방법은 Content·Media 문서를 참조하세요.

API

아래 모든 엔드포인트의 기준 URL은 https://cma.weegloo.com/v1이며, Authorization 헤더에 CMA를 인증하는 Bearer 토큰이 필요합니다. 수정·부분 수정에는 낙관적 동시성 제어를 위해 X-Weegloo-Version 헤더(현재 리소스의 sys.version)를 함께 보내야 합니다. 생성과 삭제에는 이 헤더가 없습니다.

  • Content: metadata.tags로 Tag를 다는 본문 데이터.
  • Media: metadata.tags로 Tag를 다는 파일 리소스.