API Reference · 룰렛·티켓

티켓함 조회

현재 사용자가 사용할 수 있는 티켓의 전체 수량과 유형별 잔여 수량을 조회합니다.

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

요청

Authorization: Bearer sess_*가 필요하며, 경로의 content_id는 세션 콘텐츠와 같아야 합니다. 경로는 콘텐츠 아래에 있지만 티켓함은 매체 사용자 전체에 공통입니다.

shell

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

응답

200 — available_total은 전체 사용 가능 수량입니다. types는 유형별 ticket_type_id·code·name·available_count·next_expires_at·metadata를 제공합니다. next_expires_at은 만료 예정 티켓이 없으면 null입니다. 조회 시 만료가 반영됩니다.

json

{
  "available_total": 3,
  "types": [{
    "ticket_type_id": "<ticket_type_uuid>",
    "code": "daily",
    "name": "일일 이용권",
    "available_count": 3,
    "next_expires_at": "2026-10-05T00:00:00.000Z",
    "metadata": {}
  }]
}

개별 ticket_id는 반환하지 않습니다. 룰렛 상세의 허용 유형과 교집합에 잔여 수량이 있는지 확인하고, 추첨에는 ticket_type_id만 전달하세요. 서버가 해당 유형의 만료 임박 티켓을 먼저 선택합니다.

오류

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