🔌 개발자 친화적 API
API 연동 가이드
REST API, WebSocket, Webhook으로 쉽고 빠르게 연동. 상세한 문서와 샌드박스 환경을 제공합니다.
Protocol
HTTPS / WSS
Format
JSON
Auth
OAuth 2.0 / API Key
Rate Limit
1000 req/min
Latency
< 50ms
Uptime
99.9% SLA
연동 프로세스
5단계로 완료되는 간단한 연동 과정
01
01
상담 및 요구사항 분석
비즈니스 모델에 맞는 스포츠북 제공사 및 종목을 선정합니다.
- •필요한 스포츠 종목 선정
- •제공사 비교 및 추천
- •예상 트래픽 분석
- •기술 요구사항 검토
예상 소요: 1-2일
02
02
계약 및 샌드박스
계약 체결 후 테스트 환경(샌드박스)을 제공합니다.
- •API 이용 계약 체결
- •테스트 API 키 발급
- •샌드박스 환경 접속
- •기술 문서 제공
예상 소요: 2-3일
03
03
개발 및 연동
API 문서를 기반으로 연동 개발을 진행합니다.
- •REST API / WebSocket 연동
- •배당 데이터 파싱
- •베팅 슬립 구현
- •정산 로직 개발
예상 소요: 2-4주
04
04
테스트 및 검증
연동 완료 후 종합 테스트를 진행합니다.
- •배당 정확성 검증
- •베팅 플로우 테스트
- •정산 테스트
- •부하 테스트
예상 소요: 1주
05
05
프로덕션 전환
테스트 완료 후 프로덕션 환경으로 전환합니다.
- •프로덕션 API 키 발급
- •DNS 설정
- •모니터링 설정
- •24/7 지원 시작
예상 소요: 1-2일
API 유형
용도에 맞는 다양한 API 제공
REST API
표준 HTTP 기반 RESTful API로 간편한 연동
- ✓JSON 응답 포맷
- ✓OAuth 2.0 인증
- ✓Rate Limiting 지원
- ✓Versioning 지원
WebSocket
실시간 데이터를 위한 양방향 통신
- ✓실시간 배당 스트리밍
- ✓자동 재연결
- ✓메시지 압축
- ✓Heartbeat 체크
Webhook
이벤트 기반 알림 시스템
- ✓경기 상태 변경
- ✓정산 완료 알림
- ✓베팅 결과 알림
- ✓재시도 메커니즘
주요 엔드포인트
API 엔드포인트 미리보기
https://api.sportsbookapi.com/v1GET
/sportsGET
/leagues/{sportId}GET
/matchesGET
/matches/{matchId}GET
/odds/{matchId}POST
/betsGET
/bets/{betId}POST
/cashoutGET
/settlementsWS
/ws/odds코드 예시
간단한 API 호출 예시
REST API - 배당 조회JavaScript
const response = await fetch(
'https://api.sportsbookapi.com/v1/odds/12345',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
const odds = await response.json();
console.log(odds);
// {
// "match_id": "12345",
// "market": "1X2",
// "odds": { "home": 1.85, "draw": 3.50, "away": 4.20 }
// }WebSocket - 실시간 배당JavaScript
const ws = new WebSocket(
'wss://ws.sportsbookapi.com/v1/odds'
);
ws.onopen = () => {
ws.send(JSON.stringify({
action: 'subscribe',
match_ids: ['12345', '12346']
}));
};
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log('Odds updated:', data);
};SDK 지원
다양한 언어의 공식 SDK 제공
🟨
JavaScript
🔷
TypeScript
🐍
Python
☕
Java
🐘
PHP
🔵
Go