토렌트 기어

라이브 게임을 플랫폼에 연결하기위한 API의 작동 방식

1) 일반적인 아키텍처 및 구성 요소 역할

운영자 플랫폼 (Casino Platform): 계정, 지갑, 보너스 엔진, 한도, KYC/AML, 트랜잭션 로그.

라이브 게임 제공 업체 (Studio/Provider): 스튜디오, 딜러, 비디오 스트림 (WebRTC/Low-Latency HLS), 게임 서버 라운드.

Aggregator (때로는): 수십 개의 공급자를위한 단일 API, 통화/제한/이벤트 통일.

클라이언트 프론트 엔드: 베팅 UI, 비디오 플레이어, 채팅, 로컬 프롬프트가있는 웹/모바일 클라이언

보조 서비스: 위험/사기 방지, 로깅, 분석, 메시지 대기열 (Kafka/RabbitMQ), 모니터링.

일반적인 토폴로지: → 클라이언트 (JWT) → 플랫폼 (서버 간) → 공급자, 동시에 클라이언트는 CNC/미디어 서버 풀에서 비디오 스트림을받습니다.

2) 플레이어 수명주기 및 세션

2. 1. 로그인 및 "게임 토큰"

1. 플레이어가 플랫폼에 로그인합니다.

2. 이 플랫폼은 공급자 (S2S) 에서 CreateGameSession을 호출하고 책임있는 게임의 플래그 인 '플레이어 _ id', '통화', '국가', '베팅 _ 한계' 를 전송합니다.

3. 공급자는 일회성 게임 _ 토큰을 반환하고 _ url을 시작합니다.

4. 클라이언트는 '게임 _ 토큰' 을 추가하여 iframe/새 탭에서 'runch _ url' 을 엽니 다 (또는 게임의 최종 탭에 302를 가져옵니다).

S2S 요청의 예:

http
POST/api/v1/세션
콘텐츠 유형: 응용 프로그램/json
승인: 베어러 <platform _ api _ key>

{
"player _ id": "u-918273", "setion _ id": "sess-5f3b2", "currency": "EUR", "country": "DE", "lang": "de", "bet _ limites": {"min": 0. 5, "max": 2000}, "책임 _ 게임": {"자체 _ 제외": 거짓, "deposit _ limited _ left": 150}, "callback _ urls": {
"밸런스": "https ://platform. 예. com/wallet/balance "," debit ":" https ://platform. 예. com/wallet/debit, "" credit ":" https ://platform. 예. com/wallet/credit "," 롤백 ":" https ://platform. 예. com/wallet/rollback, "" 이벤트 ":" https ://platform. 예. com/게임/이벤트 "
}
}

공급자 응답:

json
{
"game _ token": "gtkn _ 7f0... e2a", "launch _ url": "https ://live. 공급자. com/launch/rulette, "" 만료 ": 900
}

2. 2. 앞면의 인증

게임은 백엔드를 통해 '게임 _ 토큰' 을 검증합니다.

베팅/이벤트를 위해 WebSocket이 게임 서버에 설치됩니다.

비디오 스트림은 WebRTC (낮은 대기 시간 0) 를 통해 실행됩니다. 5-2 s) 또는 LL-HLS (2-5 s).

3) 돈과 베팅: 지갑 API 및 demmpotence

3. 1. 균형 및 직불/신용

공급자는 플레이어의 "돈" 을 저장하지 않습니다. 플랫폼 월렛 API라고합니다

'GET/지갑/밸런스? 플레이어 _ id '→ 전류를 사용할 수 있습니

'POST/wallet/debit' → 내기를 작성하십시오.

'POST/wallet/credit' → 신용 상금/반품.

'POST/지갑/롤백' → 라운드가 취소되면 트랜잭션을 롤백합니다.

중요: 모든 통화 거래는 'tradection _ id '/' round _ id' 입니다. 동일한 쿼리를 반복하면 결과가 변경되지 않습니다.

직불 (속도) 의 예:

http
POST/지갑/직불
이데올로기 키: trx-7a2df-001
콘텐츠 유형: 응용 프로그램/json

{
"player _ id": "u-918273", "round _ id": "r-2025-10-18-12: 30: 15Z-001", "trange _ id": "trx-7a2df-001", 금액 ": 25. 00, "통화": "EUR", "bet _ style": "roulette _ straight", "meta": {"table _ id": "ru-11", "선택": "17", "확률": 35}
}

3. 2. 타이밍 및 베팅 상태

WINDOW _ OPEN → WINDOW _ CLOSING → WINDOW _ CLOSED. 'WINDOW _ CLOSED' 이후 공급자는 새 직불 결제를 금지합니다.

늦은 입찰은 'LATE _ BET' 코드로 거부됩니다.

연결이 끊어지면 클라이언트가 베팅을 다시 종료 할 수 있습니다. 서버는 Idempotency-Key로 복제본을 구별 할 수 있어야합니다.

거래 상태: 'PENDING', 'SETTLED', 'ROLLED _ BACK', 'REJECTED'.

4) 라운드 이벤트: 모델 및 주문

4. 1. 웹 소켓 이벤트 스키마

'라운드. '→' round _ id ', 베팅 타이머가 시작되었습니다.

'내기. 수락/거부 '→ 각 입찰에 대한 확인.

'라운드. 닫힌 '→ 베팅은 더 이상 허용되지 않습니다.

'라운드. 결과 '→ 결과 (룰렛/카드/뼈 섹터).

'지불. '→ 플레이어가 이겼습니다.

'라운드. '→ 최종 상태, 체크섬.

결과 이벤트의 예:

json
{
"유형": "라운드. 결과, "" round _ id ":" r-2025-10-18-12: 30: 15Z-001 "," table _ id ":" ru-11 "," 페이로드 ": {
"룰렛": {"번호": 17, "컬러": "검은 색"}, "해시": "sha256: 8a7b... d1c", "비디오 _ ts": "2025-10-18T12: 30:23. 450Z "
}
}

4. 2. 일관성 및 체크섬

각 이벤트에는 'seq' 및 'sign' (요청 본문의 mSL + 서명) 이 제공됩니다.

조정을 위해 'payout _ chaschem' 이 지정됩니다. 모든 'round _ id' 크레딧의 합계가 수렴되어야합니다.

5) 비디오 스트림 및 대기 시간

라이브 핸드 베팅 용 WebRTC (블랙 잭/바카라/룰렛) -고객에게 엄격한 지연 예산 <2 초

시청자/규모의 LL-HLS/DASH는 2-5c를 허용합니다.

시간 동기화: NTP/chrony, 페이로드 - 재생 및 분쟁을위한 '비디오 _ ts'.

폴백: WebRTC가 분해되면 늦은 베팅을 차단하여 LL-HLS → 로 자동 전환하십시오.

6) 오류, 레트라, 타임 아웃

일반 규칙:

모든 S2S는 800-1500ms의 타임 아웃으로 전화를 걸고 지수 일시 정지 및 Jitter로 배상하지만 돈을 다시 변경하지 않습니다 (demotency).

지갑 오류 코드:

'INSUFFICIENT _ FUNDS', 'LIMIT _ EXCEEDED', 'ACCOUNT _ LOCKED', 'DUPLICATE _ TRANSACTION', 'LATE _ BET', 'CURNCY _ MISMATCH'.

오류 형식:

json
{
"오류": "INSUFFICIENT _ FUNDS", "메시지": "균형 18. 00 <25 필요. 00 "," trange _ id ":" trx-7a2df-001 "
}

7) 보너스, 프리 스핀, 보험

"돈" 지갑과 병행하여 보너스 잔액이있을 수 있습니다. 페이로드는 상각 소스의 출처를 나타냅니다	BONUS '.
라이브 게임의 경우 보험/사이드 베팅은 드문 일이 아닙니다 (예: 블랙 잭). 이는 자체 한계 및 계수가있는 별도의 거래입니다.
반올림 규칙: 뱅킹 (하프 투 짝수) 또는 플레이어/운영자를 선호하여 통합 설정에서 수정해야합니다.

8) 책임있는 플레이 및 제한

세션 플래그: '자체 _ 제외', '쿨 다운 _ 때까지', '손실 _ 한계 _ 왼쪽', '시간 _ 한계 _ 왼쪽'.

공급자는 직불 전에 '확인 _ 제한' 을 요청할 수 있습니다.

플랫폼은 force _ close _ sestion을 시작할 수 있습니다. 플레이어는 한계를 제외/초과합니다. → 공급자가 베팅 창을 닫고 플레이하지 않은 베팅에서 반환합니다.

9) 안전 및 준수

S2S, HSTS, 엄격한 IP 허용리스트 용 mTLS.

프론트 엔드 토큰, 잠재 고객/발급자 확인을위한 짧은 TTL이있는 JWT/JWS.

공급자의 웹 후크 서명 (본체 위의 HMAC-CHA256).

딜러 활동 로그, 라운드 리플레이, 불변의 감사 (WORM 스토리지).

개인 데이터 저장 - PII 최소화, 'player _ id' 토큰 화, 관할권 유지 기간 (GDPR 및 유사체).

CreateGameSession 레벨에서 관할권에 의한 지리 차단 및 금지.

10) 화해와 재정

10. 1. 시간별/일일 보고서

공급자는 'round _ id → total _ bets, 총 _ wins, 수수료' 에 대한 보고서를 제공합니다. 플랫폼은 다음을 결합합

Debits = 겠습니다. 크레딧 = 로 승리 + 반품, Delta = GGR (보너스/잭팟/커미션 포함).

보고서 형식:

json
{
"날짜": "2025-10-18", "통화": "EUR", "표": [{
"table _ id": "ru-11", "rounds": 1260, "total _ bets": "45230. 00 "," 총 _ 지불 ":" 43012. 50, "" jackpot _ contrib ":" 302. 00, "" provesser _ fee ":" 2. 5%"
}]
}

10. 2. 롤백 시나리오

비디오/스토리 보드 → 라운드가 실패했습니다. 취소: 공급자는 라운드의 모든 베팅에 '롤백' 을 보냅니다.

이중 직불 처리는 플랫폼 → 'DUPLICATE _ TRANSACTION' 및 200 OK에서 동일한 결과로 포착되었습니다.

11) 채팅, 중재 및 UI 이벤트

채팅 이벤트는 스톱 워드 필터가있는 별도의 채널 (웹 소켓 # 2) 을 통과합니다.

시스템 알림 (가까운 베팅, 승자 목록) -서명/타임 스탬프 된 신뢰할 수있는 공급자 소스에서만 가능합니다.

12) 테스트 및 인증

샌드 박스 제공 업체: 고정 된 결과, 강제 라운드 기능. 결과 '.

QA 윤곽: 잘린 베팅 창 (5-8 c) 및 가속 흐름이있는 테스트 테이블.

로드: 5-10 만 명의 동시 플레이어 시뮬레이션, 초당 최대 직불 (TPS) 5.

통합 인증: demotency, 통화, 반올림, 처리 중단, 한계 준수 및 자체 제외에 대한 점검표.

13) 측정 및 SLO

'직불/신용' 에 대한 중간/95p 대기 시간, 웹 소켓 왕복, 시간 동기화 오류, 드롭 레이트 WebRTC.

지정학: 베팅 합격률, 늦게 베팅 한 비율, 분쟁 비율, 요금 환급, 세션 기간, 유지, ARPU/LTV.

SLO 예:

99. 5% '직불' 2 초, 99. 9% 배달. 결과 '고정 후 300ms, 비디오 지연 95p WebRTC의 경우 5 초.

14) 다국적, 세금, 현지화

공급자 외부의 전환: 게임은 세션 통화에서 엄격하게 작동합니다.

세금/공제-플랫폼 측면에서 '신용' (필드 '원천 징수').

현지화: 'lang', 숫자/통화 형식, 타이머 및 보고서의 시간대.

15) 통합 옵션

1. 직접 제공 업체: 최대 제어 및 기능이지만 별도의 계약/인증.

2. 애그리 게이터를 통해: 공급자의 빠른 범위, 통합 체계, 때로는 유연성이 떨어집니다.

3. 하이브리드: 상단 테이블은 직접, 나머지는 애그리 게이터를 통해 이루어집니다

16) 미니 사양 (총)

16. 1. 웹 소켓 인바운드 (클라이언트 간 공급자)

json
{"유형": "내기. 장소, "" 베팅 ": {
"양": 25, "선택": "17", "표 _ id": "ru-11"
}, "dedempotency _ key": "c3a2-... -001"}

16. 2. 웹 소켓 아웃 바운드 (클라이언트에 제공자)

json
{"유형": "내기. "" bet _ id ":" b-8821 "," seq ": 12031}
{"유형": "라운드. 닫힌 "", round _ id ":" r-... 001 "," seq ": 12050}
{"유형": "라운드. 결과, "" 결과 ": {" 숫자 ": 17," 색상 ":" black "}," seq ": 12070}
{"유형": "지불. "" 금액 ": 875," 통화 ":" EUR "," seq ": 12075}

16. 3. 지갑 S2S (플랫폼 표시기 공급자)

'POST/wallet/debit' (deidempotent)

'POST/지갑/크레딧' (idempotent)
'POST/지갑/롤백' (idempotent)

HMAC 시그니처, 'Timestamp', 'Nonce', 반복 보호 (TTL 계정 60 c).

17) 가장자리 케이스 및 닫는 방법

플레이어 단절: 내기, 확인 없음 → 동일한 'Idempotency-Key' 로 반복; 서버가 같은 상태로 응답합니다.

라운드의 딜러/데크 변경: 자동 취소 및 전체 '롤백'.

통화 불일치: 'CURENCY _ MISMATCH' + 이벤트 로그; 세션이 다시 릴리스 될 때까지 게임이 차단됩니다.

게임 당시의 자체 제외: 즉시 'force _ close _ sesion', 재생되지 않은 상태 로 돌아갑니다.

비디오 품질 변경: 클라이언트 만, 타이머/베팅에는 영향을 미치지 않습니다.

웹 소켓 재 핸드 셰이크: 순서를 잃지 않고-' seq '가있는 이벤트 대기열, "따라 잡기" 가 누락되었습니다.

18) 생산 출시 점검표

안전

mSL + 피닝 인증서, IP 허용리스트.
모든 웹 후크에 서명하고 'Timestamp '/' Nonce' 를 확인하십시오.
미니 PII: 'player _ id' (토큰 화) 만.

신뢰성

모든 통화 거래의 신원.
라운드 리플레이 및 변경 불가능한 감사.
WebRTC → LL-HLS 자동 폴백.

제품

한계/책임 플레이가 실시간으로 적용됩니다.
내기 시점에 기본 프롬프트.
대시 보드 SLO + 는 연중 무휴 경고합니다.

라이브 게임 통합 API는 메시지 주문, 타이밍 및 보안에 대한 엄격한 요구 사항이있는 낮은 대기 시간 스트림, 이벤트 버스 및 dempotent 지갑 묶음입니다. 성공적인 구현은 엄격한 베팅 및 라운드 수명주기, 검증 가능한 일관성 (조정), 데이터 보호 및 책임있는 플레이 제한에 의존하며 "아름다운 방송" 을 신뢰할 수 있고 인증 된 금융 상품으로 전환합니다.