API Reference · 룰렛·티켓

매체 룰렛 목록

매체사·콘텐츠사 서버가 게시된 룰렛과 연결된 지급 경로를 조회합니다.

GET/api/v1/roulettes

인증과 범위

Authorization: Bearer sk_pub_* 또는 sk_prov_*가 필요합니다. 매체사는 자기 매체의 게시된 그룹을 조회하고, 콘텐츠사는 자기 콘텐츠에 활성 지급 경로가 있는 그룹만 조회합니다. 콘텐츠사 응답의 payout_routes도 자기 콘텐츠 경로만 포함합니다. 이 API는 사용자의 이용 가능 여부를 판정하지 않습니다.

요청 예시

shell

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

응답

200 — items 배열. scope는 publisher(매체 공통) 또는 publisher_content(특정 매체 콘텐츠)입니다. publisher_content_id는 공통 그룹에서 null입니다. accepted_ticket_type_ids가 비어 있으면 해당 매체의 모든 티켓 유형을 허용합니다. amount_mode는 absolute 또는 multiplier, completion_policy는 stop·repeat_last·loop입니다.

json

{
  "items": [{
    "roulette_group_id": "<group_uuid>",
    "publisher_id": "<publisher_uuid>",
    "publisher_content_id": null,
    "scope": "publisher",
    "name": "주말 룰렛",
    "amount_mode": "absolute",
    "completion_policy": "stop",
    "starts_at": null,
    "ends_at": null,
    "accepted_ticket_type_ids": ["<ticket_type_uuid>"],
    "payout_routes": [{
      "publisher_content_id": "<publisher_content_uuid>",
      "content_id": "<content_uuid>",
      "campaign_id": "<campaign_uuid>",
      "event_id": "<event_uuid>"
    }]
  }]
}

오류

401 UNAUTHORIZED — 키가 없거나 유효하지 않습니다.
403 FORBIDDEN — 허용되지 않은 인증 주체입니다.

가중치·재고는 반환하지 않습니다. 콘텐츠 웹의 현재 이용 가능 여부는 세션 토큰으로 콘텐츠 룰렛 목록을 조회하세요.