경품 룰렛을 내 웹사이트에

개발자 문서

스트리머들이 쓰는 애니메이션 룰렛·가챠 머신을 쇼핑몰, 커뮤니티, 이벤트 페이지에 코드 한 줄로 임베드하세요. 방문자가 그 자리에서 스핀하고, 서버에서 트리거하고, 모든 결과가 내 시스템으로 들어옵니다.

<script src="https://wheelofitem.com/embed.js" data-key="pk_live_내_키" data-widget="wheel"></script>

방문자 스핀 연동은 이게 전부입니다. 룰렛 디자인은 대시보드에서 만듭니다.

🖱️ 방문자가 페이지에서 스핀

위젯 아래 스핀 버튼. 1인당 일일 한도를 직접 설정하고, 추첨은 서버에서 결정 — 조작 불가.

내 시스템에서 트리거

POST /api/v1/trigger에 시크릿 키로 요청 — 가입·미션 완료·목표 달성 후에. 페이지를 보는 모두의 화면에서 라이브로 돌아갑니다.

결과는 서명된 웹훅으로

모든 스핀 결과가 HMAC 서명과 함께 내 엔드포인트로 POST — 결과 기록과 연동에 바로 사용.

내 디자인, 공통 엔진

스트리머와 같은 대시보드에서 룰렛/가챠 제작 — 같은 물리엔진, 같은 애니메이션, 같은 귀여운 테마.

Pro에 포함

₩4,500 / 월
  • 내 웹사이트에서 월 2,000 스핀
  • 5종 전부 — 룰렛·가챠·타로·인형뽑기·포토부스 — 하나의 쿼터 공유
  • 웹사이트 1개 (도메인 최대 3개 — 스테이징 포함)
  • wheelofitem.com 스트리머용 Pro 전체도 함께

Embed Plus — 방문자가 많은 사이트용

₩6,500 / 월
  • 월 50,000 스핀
  • Pro 기능 전부 포함
  • 위젯·트리거 API·웹훅은 동일
  • 카드 월간 구독 · 언제든 해지
14일 무료 체험

체험 14일: Pro 포함, 2,000 스핀, 카드 불필요. 1 스핀 = 방문자 스핀 1회 또는 API 트리거 1회. 방문자별 하루 한도를 정할 수 있고, 월 한도에 닿으면 다음 달까지 멈춥니다.

자주 묻는 질문

어떤 위젯을 임베드할 수 있나요?

5종 전부 — 룰렛·가챠·타로·인형뽑기·포토부스. 각각 따로 설정하거나 전부 사용 — 사용량은 하나의 쿼터로 합산됩니다.

결과는 어떻게 받나요?

페이지에서는 즉시(애니메이션 + JavaScript postMessage), 서버에서는 각 스핀 후 약 1분 안에 서명된 웹훅으로 도착합니다.

내 시스템에서 스핀을 발동할 수 있나요?

네 — 시크릿 키로 POST /api/v1/trigger. 내 사이트의 "가입 → 스핀", "목표 달성 → 스핀"에 딱 맞습니다. 가치 있는 경품 당첨 기회를 판매하는 용도로는 사용할 수 없습니다(이용약관).

한도와 해지는요?

Embed는 Pro에 포함돼요: 웹사이트 1개(도메인 최대 3개)에서 월 2,000 스핀, 방문자별 하루 한도도 직접 설정. 더 필요하면 Embed Plus(월 50,000 스핀, 한국 ₩6,500, Pro 포함). 먼저 14일 무료 체험(Pro 포함, 카드 불필요), 언제든 해지 가능.

개발자 문서 읽기 →