API Reference · 룰렛·티켓

미수령 당첨 조회

지연 지급으로 뽑았지만 아직 '보상 받기'를 하지 않은 사용자의 당첨을 조회합니다. 진입 시 미수령 팝업을 다시 띄우는 데 씁니다.

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

요청

Authorization: Bearer sess_*가 필요하며, 경로의 content_id는 세션 콘텐츠와 같아야 합니다. 본문·쿼리 파라미터는 없습니다.

대상은 세션 회원의 그 매체 미수령 당첨입니다. 경로는 콘텐츠 아래에 있지만 그 매체의 룰렛이면 어느 콘텐츠에서 뽑았든 포함합니다. 오래된 추첨부터 최대 20건을 돌려주며 기간 제한은 없습니다.

shell

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

응답

200 — draws의 각 항목은 룰렛 추첨 응답과 같은 모양이며 모두 claim_status: "unclaimed"입니다. 아직 지급하지 않았으므로 postback_id는 null이고 delivery·delivery_code는 없습니다. 이미 저장된 추첨을 다시 읽은 것이므로 duplicate는 true이고, remaining_tickets는 그 추첨에 쓴 티켓 유형의 현재 잔여 수량입니다. 미수령이 없으면 { "draws": [] }입니다.

json

{
  "draws": [
    {
      "draw_id": "<draw_uuid>",
      "roulette_group_id": "<group_uuid>",
      "roulette_id": "<roulette_uuid>",
      "roulette_version": 1,
      "ticket_id": "<consumed_ticket_uuid>",
      "reward": { "slot_id": "<slot_uuid>", "label": "100P", "display_order": 0,
        "reward_type": "point", "point": 100 },
      "event_log_id": "<event_log_uuid>",
      "postback_id": null,
      "remaining_tickets": 2,
      "duplicate": true,
      "claim_status": "unclaimed"
    }
  ]
}

진입 시 미수령 안내

콘텐츠 진입 때 이 API를 호출하고, 항목이 있으면 당첨 팝업을 다시 띄워 사용자가 '보상 받기'를 누르면 그 draw_id로 당첨 보상 받기를 호출하세요. 보상을 받은 추첨은 목록에서 빠집니다. 20건을 넘게 쌓였으면 받은 뒤 다시 조회해 다음 건을 이어서 표시하세요. 꽝과 즉시 지급(claim 생략)으로 뽑은 추첨은 목록에 나오지 않습니다.

오류

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