🚀
게임 실행
오퍼레이터 서버가 POST /launch 로 1회용 실행 URL 을 받아 플레이어를 새 창이나 iframe 으로 보냅니다. 플레이어 인증은 60초짜리 1회용 토큰으로 끝납니다.
게임 실행 흐름
R-Live Games API오퍼레이터 연동 API 문서
서버 간 API 로 게임을 실행하고, 심리스 지갑 콜백으로 플레이어 머니를 주고받습니다. 라이브 딜러 게임과 RNG 게임을 한 번의 연동으로 제공합니다.
서버 간 API 로 게임을 실행하고, 심리스 지갑 콜백으로 플레이어 머니를 주고받습니다. 라이브 딜러 게임과 RNG 게임을 한 번의 연동으로 제공합니다.
오퍼레이터가 구현할 것은 두 가지입니다. 게임 화면 · 실시간 진행 · 라이브 영상은 플랫폼이 제공합니다.
| 통로 | 방향 | 오퍼레이터가 할 일 |
|---|---|---|
| Operator API | 오퍼레이터 서버 → 플랫폼 | 게임 실행 URL 발급(POST /launch), 게임 · 테이블 목록, 라운드 · 거래 내역 조회 |
| 지갑 콜백 | 플랫폼 → 오퍼레이터 서버 | balance · debit · credit · rollback 4종 수신 · 처리 |
| 게임 화면 | 플레이어 브라우저 ↔ 플랫폼 | launch_url 로 새 창 또는 iframe 열기 (구현 불필요) |
balance · debit · credit · rollback 을 tx_id 멱등으로 처리합니다. → 지갑 콜백POST /launch 로 받은 launch_url 로 플레이어를 보냅니다. → 게임 실행 흐름| 구분 | 문서 | 내용 |
|---|---|---|
| 시작하기 | 연동 개요 | 구성 요소, 용어, 운영 방식(credit_mode), 제공 게임 |
| 연동 절차 · 환경 | 진행 순서, 주고받는 정보, 환경별 주소 | |
| 인증 · 서명 | 요청 헤더, 서명문, 예시 코드, 테스트 벡터 | |
| 공통 규약 | 금액 · 시각 · ID 형식, 페이징, 오류 응답, 속도 제한 | |
| 게임 실행 흐름 | 실행 요청, 창 열기, postMessage 이벤트, 언어 · 통화 | |
| 지갑 콜백 | 개요 · 멱등 · 재시도 | 콜백 공통 규칙, 타임아웃 · 재시도, 호출 순서 |
| balance · debit · credit · rollback | 콜백별 요청 · 응답 · 오류 | |
| Operator API | 전체 목록 | 엔드포인트 한 장 요약 |
| 게임 실행 · 게임 · 로비 · 통화 · 테이블 · 플레이어 | 실행 · 조회 · 관리 API | |
| 라운드 · 거래 · 리포트 · 오퍼레이터 설정 · 알 | 내역 · 정산 · 설정 API | |
| 딜러 · 프라이빗 테이블 · 변경 이력(감사) | 운영 관리 API | |
| 오류 코드 | 오류 코드 전체 목록 | |
| 부록 | 게임 코드 | game_code 목록과 지갑 흐름 |
| 연동 체크리스트 | 운영 전환 전 점검 항목 |
| 환경 | Operator API 베이스 URL | 게임 화면 오리진 |
|---|---|---|
| 테스트 | {API_BASE}/operator/v1 — 연동 시 제공 | {GAME_ORIGIN} — 연동 시 제공 |
| 운영 | {API_BASE}/operator/v1 — 운영 전환 시 제공 | {GAME_ORIGIN} — 운영 전환 시 제공 |
주소는 환경별로 발급하며 바뀔 수 있고, 바뀔 때는 미리 알려 드립니다. 자격증명도 환경마다 따로 발급됩니다. 자세한 내용은 연동 절차 · 환경을 보세요.
| 구분 | 게임 |
|---|---|
| 라이브 | 라이브 홀덤, 스피드 홀덤(클래식 · 블라인드 · 플랍 · 히든), 바카라, 블랙잭 |
| RNG | 텍사스 홀덤, 팟리밋 오마하, 맞고, 고스톱, 섯다, 바둑이, 통잇, 레드독 |
오퍼레이터마다 켜진 게임은 GET /games 로 확인합니다. 코드 목록은 게임 코드를 보세요.