크립토 카지노
토렌트 기어
공급자를위한 단일 API: 디자인, 버전, 호환성
전체 기사
1) "단일 API" 와 그 이유
단일 API는 모든 컨텐츠 제공 업체 (RGS, 라이브 스튜디오, 잭팟, KYC/AML, 계열사) 가 동일한 규칙에 따라 플랫폼과 통신하는 사양 및 엔드 포인트/이벤트 세트입니다
통합 리소스 모델 (플레이어, 세션, 베팅, 결제, 보너스, 잭팟, 지불), 일반적인 이벤트 계약 및 식별자, 보안 및 이전 호환성 표준, 통합 속도를 높이는 SDK/도구.
목표는 통합 시간을 줄이고 "돈 경로" 의 오류를 줄이며 예측 가능한 업그레이드를 제공하는 것입니다.
2) 디자인 원칙
1. 도메인 우선. 첫째, 사전 및 불변 (속도, 설정, RG 제한), 끝점.
2. 기본적으로 호환성. 모든 변경 사항은 기본적으로 호환됩니다. 프로세스별로 변경 사항을 엄격하
3. 모든 곳에서 이데올로기. 모든 돈 명령은 부작용없이 반복 가능합니다.
4. 사건은 진실의 원천입니다. 버스로의 운영 → 이벤트; 분석은 OLTP를 능가하지 않고 버스를 듣습니다.
5. 최소 특권 및 제로 트러스트. 브랜드/지역별 토큰, 서명, 세분화.
6. 관찰 가능성. 엔드 투 엔드 'trace _ id', 이해할 수있는 오류 모델, p95/p99 메트릭.
3) 리소스 모델 (단순화)
플레이어: 플랫폼 측 플레이어 pseudo-ID, 지리/통화/RG 상태.
세션: 공급자와 플랫폼 간의 채널 ('sesion _ id', TTL, geo/contriments).
내기: 내기 승인/직불.
합의: 결과를 확보하고 크레딧을 획득하십시오.
보너스/웨이거: 보너스/베이거 밸런스 상태.
대박: 기여/트리거/지불.
이벤트: 변하지 않는 도메인 이벤트 (Kafka/analogues).
식별 자: 'tenit _ id', 'brand _ id', 'region', 'player _ id', 'section _ id', 'round _ id', 'bet _ id', 'relation _ id'. 전 세계적으로 고유 한 문자열 (UUI/KSUI/Snowflake) 은 로그 및 이벤트에 포함되어 있습니다.
4) API 계약: 요청, 응답, 오류
4. 1 승인 및 보안
OAuth2 클라이언트 자격 증명 또는 mSL + 요청 본문 서명 (HMAC/EdUSA).
계정: '베팅: 쓰기', '결산: 쓰기', '세션: 읽기', '이벤트: 게시'.
각 요청마다 헤더가 필요합니다
'X-Trace-ID', 'X-Brand-ID', 'X-Region', 'X-Idempotency-Key'.
4. 엔드 포인트의 2 가지 예
세션 생성
POST/v1/세션
{
"player _ id": "p _ 19f3", "game _ id": "studio: slot _ forge _ 02", "currency": "EUR", "locale": "de-DE", "구속 조건": 5, "rg _ flags": ["자기 배제": 거짓]}
}
→ 201
{
"세션 _ id": "s _ 456", "만료 _ at": "2025-10-23T19: 10: 00Z"
}승인 승인 (보류)
POST/v1/베팅/승인
헤더: X-Idempotency-Key: bet _ r _ 8c12 _ 1
{
"sesion _ id": "s _ 456", "bet _ id": "b _ 001", "round _ id": "r _ 8c12", "mount": {"amount": 2. 00, "통화": "EUR"}
}
→ 200 {"상태": "승인 됨", "hold _ id": "h _ zz1"}정착
POST/v1/베팅/정착
헤더: X-Idempotency-Key: settle _ r _ 8c12 _ 1
{
"bet _ id": "b _ 001", "round _ id": "r _ 8c12", "win": {"amount": 14. 60, "통화": "EUR"}, "bonus _ state": {"in _ boners": 참, "freespins _ left": 7}
}
→ 200 {"상태": "크레딧", "redited _ id": "st _ 77"}4. 3 오류 (단일 모델)
'코드': 자체 'RG _ BLOCK', 'LIMIT _ EXCEEDED', 'DUPLICATE', 'IDEMPOTENCY _ MISMATCH', 'INVALID _ STATE', '보안 H _ FAILED').
'메시지': 사람을위한 브리핑.
'재시도 가능': '진실/거짓'.
'trace _ id': 로그를 검색합니다.
예:
409 CONFLICT
{
"코드": "DUPLICATE", "메시지": "이미 다른 금액으로 승인 된 내기", "재시도 가능": 거짓, "trace _ id": "tr _ a1b2c3"
}5) 이벤트 버스 및 서킷
5. 1 기본 주제
5. 2 이벤트 스키마 (Avro/JSON 스키마)
json
{
"이벤트 _ id": "uIS", "이벤트 _ 유형": "베팅. "" arched _ at ":" 2025-10-23T16: 21: 05Z "," tenent _ id ":" brand-7 "," region ":" EU "," player _ id ":" p _ 19f3 ", trace _ id": "tr _ a1b2c3," "페이로드": {
"round _ id": "r _ 8c12", "bet": {"amount": 1. 00, "통화": "EUR"}, "승리": {"금액": 14. 60, "통화": "EUR"}, "in _ borness": 참
}, "dedempotency _ key": "bet _ r _ 8c12 _ 1", "skima _ version": "1. 2. 0"
}규칙: 체계의 역 호환 진화, 레지스트리 + 계약 테스트.
6) API 버전: 전략 및 규칙
6. 1 버전을 저장할 위치
경로 버전: '/v1/... '(캐시/경로 만).
헤더 버전: '수락: 응용 프로그램/vnd. 플랫폼. api + json; 버전 = 1. 2`.
이벤트: 이벤트 필드 + 레지스트리의 '스키마 _ 버전'.
연습: HTTP를위한 경로, 이벤트를위한 스키마 _ 버전, 포인트 기능을위한 플래그 기능
6. 2 SemVer 및 변경 유형
PATCH (사소한) -리버스 도킹: 새로운 옵션 필드, 새로운 엔드 포인트, 새로운 유형의 이벤트.
메이저-속보: 필드 이름 변경, 시맨틱 변경, 삭제. 새로운 '/vN/' 과 이전의 고갈을 통해서만 허용됩니다.
6. 3 안정적인 계약 (깨질 수없는)
키 식별 필드의 이름 및 유형 ('_ id', 'demempotency _ key').
통화 모델 ('금액/통화', 정확도).
상태 의미론 ('승인 된', '신용 된', '몰수 된' 등).
이념성: 반복 행동은 엄격하게 정의됩니다.
7) 호환성과 진화
7. 1 추가 (안전)
기본값을 가진 새로운 선택적 필드.
기존 이벤트를 변경하지 않고 새로운 이벤트/엔드 포인트.
'알 수 없음' 으로 대체되는 Enum 확장.
7. 2 변경 (위험)
필드 유형 변경 (숫자 → 줄).
선택적 → 필요합니다.
비즈니스 논리 반전 ('승인' 전에 '정착').
→ 새로운 주요 버전과 마이그레이션 가이드가 필요합니다.
7. 3 탈퇴
필드/엔드 포인트는 '더 이상 사용되지 않는 _ 이후: 1로 표시됩니다. 7 ',' 제거 _ in: 2. 0`.
커뮤니케이션: 릴리스 노트, 뉴스 레터, 디프 레이션 헤더 ('Sunset', 'Deprecation').
사전 파트너 알림에 "오래된" 경로 사용을 추적합니다.
8) 이념과 일관성
모든 레코딩 작업에는 'X-Idempotency-Key' 헤더가 필요합니다.
시맨틱: 동일한 키 → 동일한 결과 (동일한 본체의 경우 200) 로 반복하십시오.
키는 매개 변수 구성 (예: 'bet _ id + 양') 에 바인딩됩니다.
긴 프로세스에 대한 사가: '승인 → 커밋/잠금 → 결제 → 신용'; 보상- '롤백' 이벤트.
9) Pagination, 필터, 정렬
커서 기반 페이지 매김 (큰 스레드의 경우 엄격히 '페이지/제한').
통일: '? 커서 =... & limite = 200 & order = asc '.
답변: 'nether _ curder', 'has _ more'.
필터: 시간별 ('where _ at _ from/to'), 'tenant _ id', 'game _ id', '상태'.
10) 지역, 통화, 데이터 레지던트
ISO-4217의 통화; 정확도는 체계 ('스케일'), 계산-마이너 단위 (센트) 에 저장됩니다.
Locali - BCP 47 ('en-GB', 'pt-BR').
각 요청- '지역'; PII 및 현금 거래는 지역을 가로 지르지 않습니다.
BI 쇼케이스에서 PII 및 RLS 마스킹.
11) 관찰 가능성과 한계
필요한 제목: 이벤트와 상관 관계가있는 'X-Trace-ID', 'X-Provider-ID'.
측정 항목: p50/p95/p99 대기 시간, 오류율 (코드 별), 처리량, 대기열 지연 (이벤트 용).
요율 제한: 공급자/브랜드 당; '재생 후' 의 응답.
중요한 변화에 대한 WORM 감사 (한계, RTP 풀, 잭팟 공식).
12) 계약의 테스트 및 품질
계약 테스트 (Pact/others): 공급자 시험 플랫폼 이벤트 소비자.
로드: 요금/결제의 "폭풍"; p95의 목표.
혼돈 사례: 이중 배송, 주문 외, 지갑 지연.
가상의 돈으로 샌드 박스 '/샌드 박스 '와' 플레이어 _ id '를 테스트하십시오.
13) SDK, 생성기 및 문서
OpenAPI/AsyncAPI → SDK 생성 (TypeScript/Java/Kotlin/Go/Rust).
'승인/해결/롤백', 배상 및 오류 처리에 대한 코드 예.
요청/응답 (cull + JSON), Postman/Insomnia 컬렉션의 예가 포함 된 라이브 도크.
변경 유형 및 호환성 레이블이있는 Changelog.
14) 마이그레이션 로드맵 (예)
1. v1. 6 → v1. 7 (사소한) '보너스 _ state' 필드를 '정착' (선택 사항) 에 추가했습니다.
2. v1. x EOL 발표: 6 개월 동안-문자 + '우울증' 헤더 + 대시 보드 사용.
3. v2. 0 (전공): 개인 지갑. 커밋 '(이전의 암시 적), 새로운 필드' 결제 _ id '가 필요합니다.
4. 마이그레이션 가이드: 필드 매핑, 타임 라인, "이중 쓰기" ('v1 '/' v2' 이벤트의 병렬 게시)
5. 일몰 v1: 새 통합을 차단하고 SLA 예외에 대해서만 확장됩니다.
15) 점검표
플랫폼 설계자
- 도메인 엔티티 및 불변량의 단일 사전이 있습니다.
- OpenAPI/AsyncAPI + Schema Registry, semver, 감소 프로세스.
- 모든 쓰기 작업에 대한 이념성; 키가 문서화되어 있습니다.
- 단일 오류 모델 및 코드.
- Money Ways의 Sagas 및 Outbox/CDC.
- 요율 제한, 관찰 가능성, WORM 감사.
- 파트너는 샌드 박스 및 계약 테스트를 이용할 수 있습니다.
- 데이터 레지던트 및 RLS/마스킹.
공급자를 위해
- 나는 항상 'X-Trace-ID' 와 'X-Idempotency-Key' 를 보냅니다.
- 요청 반복을 안전하게 처리합니다. 나는 복식을 만들지 않습니다.
- '우울증/일몰' 처리 및 Changelog 읽기.
- 레지스트리 체계에 따라 이벤트를 게시/읽습니다. 나는 버전을 유지합니다.
- 내 편에 재 시도/백오프 및 중복 제거가 있습니다.
16) 반 패턴 (적기)
데이터베이스의 잔액/결제 수동 편집.
"과거" 아웃 박스/CDC 출판 이벤트.
demempotency → 중복 지불/직불 결제 없음.
'지역' 을 표시하지 않고 다른 지역의 PII/돈을 혼합합니다.
새 버전과 감소없이 "조용한" 변경 사항.
SDK를 수동으로 생성합니다 (실제 사양으로 드리프트).
특징 깃발과 이중 이벤트 작성이없는 빅뱅 마이그레이션.
단일 API는 "종점 모음" 일뿐만 아니라 일관된 사전, 안정적인 통화 불변량, 다양한 이벤트, 명확한 호환성 규칙 및 관리 가능한 감소와 같은 생태계 계약입니다. 시맨틱 버전, demempotency, Outbox/CDC, 관찰 가능성 및 강력한 보안에 의존하는이 플랫폼은 공급자를 빠르고 고통없이 연결하고 업그레이드하여 위험에서 일상으로 전환합니다.