API Reference · 룰렛·티켓

콘텐츠 룰렛 목록

현재 사용자의 콘텐츠 세션에서 접근할 수 있는 매체 공통·콘텐츠 전용 룰렛을 조회합니다.

GET/api/v1/contents/{content_id}/roulettes

요청

content_id는 세션 토큰의 콘텐츠 ID와 같아야 합니다. Authorization: Bearer sess_*가 필요합니다. 해당 매체 콘텐츠에 활성 지급 경로가 있는 룰렛만 반환합니다.

shell

curl -H "Authorization: Bearer <session_token>" \
  "https://added-dev.blomics.net/api/v1/contents/<content_id>/roulettes"

응답

200 — items 배열. available이 false인 그룹도 목록에 포함될 수 있습니다. starts_at·ends_at은 ISO 시각 또는 null입니다. metadata는 관리자가 저장한 표시용 확장 데이터입니다.

json

{
  "items": [{
    "roulette_group_id": "<group_uuid>",
    "name": "주말 룰렛",
    "scope": "publisher",
    "available": true,
    "starts_at": null,
    "ends_at": null,
    "metadata": {}
  }]
}

오류

401 UNAUTHORIZED / SESSION_EXPIRED — 세션 인증 실패·만료.
404 NOT_FOUND — 경로의 콘텐츠가 세션의 콘텐츠와 다릅니다.

목록의 available은 표시용 현재 상태입니다. 실제 추첨 가능 여부는 추첨 시점에 다시 판정됩니다. 상세 칸과 허용 티켓은 룰렛 상세를 조회하세요.