고객센터어드민

API Reference · 콘텐츠

콘텐츠 매체 데이터 조회

매체×콘텐츠 페어 단위로 어드민이 관리하는 운영용 JSON 데이터를 조회합니다. 세션 유저가 저장하는 사용자 콘텐츠 데이터(publisher_user_data)와는 별개의 영역으로, 어드민에서만 편집되며 외부에서는 읽기만 가능합니다.

GET/api/v1/contents/{content_id}/publisher/{publisher_id}

요청 파라미터

  • content_id (path, uuid, required) — 콘텐츠 ID.
  • publisher_id (path, uuid, required) — 매체 ID.

요청예시

shell
curl -H "Authorization: Bearer sess_prod_0192a1b2-3c4d-7e8f-9012-3456789abcde" \
  -H "Origin: https://my-content.example.com" \
  "https://added.blomics.net/api/v1/contents/{content_id}/publisher/{publisher_id}"

응답 필드

200 OK — 매체×콘텐츠 페어의 운영 데이터.

  • publisher_content_id (uuid) — 매체×콘텐츠 정션 행 ID.
  • content_id (uuid) — 콘텐츠 ID.
  • publisher_id (uuid) — 매체 ID.
  • status (string) — 페어 상태. active 또는 suspended.
  • data (object) — 어드민이 채워둔 자유형 JSON. 최상위는 항상 객체입니다. 빈 값은 {}. 광고 미디에이션 설정은 더 이상 여기 포함되지 않고 ads 로 분리되었습니다.
  • ads (object) — 매체×콘텐츠 단위 광고 미디에이션 오버라이드 JSON. 최상위는 항상 객체이며, 빈 값은 {}. 클라이언트가 콘텐츠 전역 광고 설정(/api/v1/contents/{content_id} 의 ads) 위에 머지합니다.
  • onboarded_at (ISO 8601) — 매체에 콘텐츠를 온보딩한 시각.
  • suspended_at (ISO 8601, nullable) — 중단(suspended) 처리된 시각. 활성 상태면 null.
  • publisher (object) — 매체 정보.
    • slug (string) — 매체의 전역 유일 slug(외부 노출용 식별자).

응답예시

json
{
  "publisher_content_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
  "content_id": "0193a1b2-3c4d-5e6f-7890-fedcba987654",
  "publisher_id": "0193a1b2-3c4d-5e6f-7890-1122334455aa",
  "status": "active",
  "data": {
    "min_score": 100,
    "labels": ["alpha", "beta"]
  },
  "ads": {
    "unit_id": "ca-app-pub-3940256099942544/1033173712",
    "floor_cpm": 1.5
  },
  "onboarded_at": "2026-04-24T15:36:45.165Z",
  "suspended_at": null,
  "publisher": {
    "slug": "acme-media"
  }
}

에러처리

  • 401 UNAUTHORIZED — 인증 실패. 토큰 형식 오류 또는 만료된 세션.
  • 404 NOT_FOUND — 해당 (content_id, publisher_id) 페어로 온보딩된 행이 없거나, 세션 토큰의 audience 가 URL 식별자와 일치하지 않는 경우.
  • 500 INTERNAL_ERROR — 서버 오류.