고객센터어드민

API Reference · 콘텐츠

콘텐츠 상세 조회

콘텐츠 단건 상세 정보를 조회합니다. 매체사·콘텐츠사 모두 자기 소속 콘텐츠만 조회 가능합니다.

GET/api/v1/contents/{content_id}

요청 파라미터

  • content_id (path, uuid, required) — 조회할 콘텐츠 ID.

요청예시

shell
curl -H "Authorization: Bearer sk_pub_prod_4eC39HqLyjWDarjtT1zdp7dc" \
     "https://added.blomics.net/api/v1/contents/0193a1b2-3c4d-5e6f-7890-abcdef012345"

응답 필드

200 OK — 콘텐츠 객체 단건. 필드는 /api/v1/contents 응답의 item 과 동일하며, 상세 조회에만 data · ads 필드가 추가로 포함됩니다(목록 응답에는 없음).

  • content_id (uuid)
  • name (string)
  • subtitle (string, nullable)
  • content_type (string)
  • description (string, nullable)
  • content_url (string)
  • thumbnail_url (string, nullable)
  • data (object) — 콘텐츠 단위 자유형 JSON 객체. 어드민에서 관리하며, 값이 없으면 빈 객체({}). 광고 미디에이션 설정은 더 이상 여기 포함되지 않고 ads 로 분리되었습니다.
  • ads (object) — 콘텐츠 단위(전역) 광고 미디에이션 설정 JSON. 어드민에서 관리하며, 값이 없으면 빈 객체({}). 매체별 오버라이드(/api/v1/contents/{content_id}/publisher/{publisher_id}의 ads)와 클라이언트에서 머지합니다.
  • status (string)
  • created_at (ISO 8601)
  • updated_at (ISO 8601)

응답예시

json
{
  "content_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
  "name": "퀴즈 챔피언",
  "subtitle": "매일 새로운 문제",
  "content_type": "QUIZ",
  "description": "5문제를 맞히면 보상이 지급됩니다.",
  "content_url": "https://example-provider.com/contents/quiz-champion",
  "thumbnail_url": "https://cdn.example.com/thumbs/quiz-champion.png",
  "data": {
    "min_questions": 5,
    "theme_color": "#4F46E5"
  },
  "ads": {
    "network": "admob",
    "unit_id": "ca-app-pub-3940256099942544/6300978111"
  },
  "status": "ACTIVE",
  "created_at": "2026-04-01T09:00:00.000Z",
  "updated_at": "2026-04-15T12:34:56.000Z"
}

에러처리

  • 400 INVALID_PARAM — content_id 형식 오류 (UUID 아님).
  • 401 UNAUTHORIZED — 인증 실패.
  • 404 NOT_FOUND — 콘텐츠 없음 또는 소유권 위반(404 은닉).
  • 500 INTERNAL_ERROR — 서버 오류.