API Reference · 공지사항

공지사항 상세 조회

공지 단건의 상세 정보를 조회합니다. 목록 응답에는 없는 본문(body, Markdown)이 포함됩니다.

GET/api/v1/contents/{content_id}/notices/{notice_id}

요청 파라미터

content_id (path, uuid, required) — 공지가 속한 콘텐츠 ID. 공통 공지도 노출 대상 콘텐츠 ID 로 조회합니다.
notice_id (path, uuid, required) — 조회할 공지 ID.

현재 게시 중인 공지만 조회할 수 있습니다. 게시 상태가 아니거나 게시기간을 벗어난 공지, 또는 다른 콘텐츠 전용 공지는 404 로 처리됩니다.

요청예시

shell

curl -H "Authorization: Bearer sk_pub_prod_4eC39HqLyjWDarjtT1zdp7dc" \
     "https://added.blomics.net/api/v1/contents/0193a1b2-3c4d-5e6f-7890-abcdef012345/notices/0193c1d2-3e4f-5a6b-7c8d-9e0f12345678"

응답 필드

200 OK — 공지 객체 단건. 필드는 목록 응답의 item 과 동일하며, 상세 조회에만 body 필드가 추가로 포함됩니다(목록 응답에는 없음).

notice_id (uuid)
scope (string) — common / content.
category (string) — general / event / maintenance / update.
title (string) — 공지 제목.
body (string) — 공지 본문. Markdown 형식이며, 렌더링은 콘텐츠 클라이언트에서 처리합니다.
is_pinned (boolean) — 상단 고정 여부.
starts_at (ISO 8601, nullable) — 게시 시작 시각.
ends_at (ISO 8601, nullable) — 게시 종료 시각.
published_at (ISO 8601, nullable) — 게시 시각.

응답예시

json

{
  "notice_id": "0193c1d2-3e4f-5a6b-7c8d-9e0f12345678",
  "scope": "common",
  "category": "maintenance",
  "title": "정기 점검 안내",
  "body": "## 정기 점검 안내\n\n6월 1일 00:00 ~ 02:00 (KST) 동안 서비스 점검이 진행됩니다.\n점검 중에는 일부 기능 이용이 제한될 수 있습니다.",
  "is_pinned": true,
  "starts_at": "2026-06-01T00:00:00.000Z",
  "ends_at": "2026-06-02T00:00:00.000Z",
  "published_at": "2026-05-31T09:00:00.000Z"
}

에러처리

400 INVALID_PARAM — content_id / notice_id 형식 오류(UUID 아님).
401 UNAUTHORIZED — 인증 실패.
404 NOT_FOUND — 공지 없음 / 미게시 / 게시기간 외 / 다른 콘텐츠 전용 공지, 또는 콘텐츠 소유권 위반(404 은닉).
500 INTERNAL_ERROR — 서버 오류.