API GUIDE
-
API 데이터에 액세스하려면 플랜 구매시 받은 고유 인증키와 필수 파라미터를 입력해야 합니다.
-
무료 테스트 자격에서는 일부 항목의 접근이 제한됩니다.
-
API 호출시 과도한 트랙픽을 발생시키는 경우 일시적으로 호출이 제한될 수 있으니 플랜에 따라 권장되는 호출 주기를 확인해서 이용해주시기 바랍니다.
-
API 사용에 어려움이 없도록 반드시 아래의 가이드 내용을 확인하시고 이용중 문제가 있는 경우 언제든 서포트팀 텔레그램으로 문의 하시기 바랍니다.
SPORTS ID
제공되는 스포츠 종목들은 모두 고유한 id를 갖고 있으며 독립적으로만 호출이 가능합니다. API 엔드포인트 이후 파라미터 sport=[id] 에서 원하는 종목의 [id]를 넣어 호출할 수 있습니다.
PARAMETERS
API 요청시 필요한 파라미터에 대한 설명입니다. API 엔드포인트 이후 token=&sport=&date=&game_id= 등으로 요구됩니다.
REFERENCE URL
API 사용에 편리를 위해 제공되는 Reference API에 대한 url 안내입니다. Reference API는 유료 플랜에서만 제공되며 무료 테스트 이용시에는 제공되지 않습니다.
EMBLEM URL
국가 및 팀 엠블럼에 대한 url 안내입니다. API response 에서 국기 이미지는 엔드포인트 이후 "resion"의 id를 넣으면 되고 엠블럼 이미지는 "team_img" 값을 넣으면 됩니다. 이미지 요청은 유료 플랜에서만 제공되며 무료 테스트 이용시에는 제공되지 않습니다.
PRE-MATCH API
프리매치 베이직은 베이직 마켓의 오즈를 포함한 지정한 일자의 전체 예정 경기를 하나의 호출로 출력합니다. 프리매치 프로는 지정한 단일 경기를 고유한 game_id를 입력하여 호출하며 game_id는 베이직 리스트에서 얻게됩니다. 프로 플랜의 마켓은 베이직 마켓을 포함하며 베이직 플랜보다 많은 다양한 오즈 마켓이 제공됩니다.
-
프리매치 API 권장 호출 주기: 1~2 분
IN-PLAY API
인플레이는 라이브 경기 데이터와 실시간 오즈를 제공합니다. 인플레이 데이터는 매 초 마다 업데이트 되며 모든 결과를 인플레이 상에서 처리할 수 있습니다. 인플레이 API는 오직 진행중인 게임만 호출할 수 있으며 종료 된 게임은 Results API에서 확인할 수 있습니다.
-
인플레이 API 권장 호출 주기: 라이브 목록 - 10 초 / 라이브 게임 - 1~2초
RESULTS API
Sport id로 호출한 모든 종목의 게임 결과를 Results API에서 확인할 수 있습니다. Results API는 호출일로부터 최대 3일 전에 종료 된 결과까지 호출할 수 있고 현재 진행중인 라이브 인플레이 경기의 실시간 스코어도 호출할 수 있습니다. 프리매치 사용자도 Results API를 적용해서 실시간 결과 처리가 가능합니다.
-
결과 API 권장 호출 주기: 1~2 분
ERROR CODE
API 요청시 반환되는 Succes code와 Error message에 대한 설명입니다.
RESPONSE DATA
프리매치와 인플레이, Results API 호출로 Response 된 데이터들의 속성에 대한 설명입니다. * 참고 항목들을 확인하시기 바랍니다.
STATUS
경기 상태를 안내하는 Status 값에 대한 설명입니다.
일반적으로 모든 경기는 Status: 0 (시작 전, 프리매치 상태) → 1 (진행중, 인플레이 상태) → 3 (경기 종료) 순으로 진행됩니다. 때문에 정상적인 Response 은 프리매치에서는 Status: 0 의 경기들만 나오고 인플레이에서는 Status: 1 의 경기들만 나오지만 월드컵과 같은 빅 리그들의 경우는 경기 시작 30여분 전에 인플레이 데이터가 오픈되는 경우도 있어서 이 경우 인플레이에서도 Status: 0 의 데이터가 출력 됩니다.
경기가 정상적으로 진행되었고 결과가 나왔지만 콜드 승, 기권 승과 같이 종료된 경기들은 Status: 2 (결과 지연, 일시적인 예외 처리중) 을 거쳤다가 종료 값으로 변경될 수 있습니다. 리그의 퀄리티가 낮은 After Match(결과 스코어만 제공되는 경기)들의 경우에도 공식 결과가 나올때까지 Status: 2 를 표시할 수 있습니다. 온라인 메이저 북메이커 대부분은 프리매치 결과에서 Status: 3(정상 종료) 이 아닌 경우 적중특례로 무효 처리를 합니다.
TIMER
인플레이 라이브 게임 API 에서 Response 되는 경기 진행중 시간 상황에 대한 안내입니다.
STATS
인플레이 라이브 게임 API 에서 Response 되는 종목별 라이브 스텟에 대한 안내입니다.
OFFENCE
인플레이 라이브 게임 API 에서 Response 되는 종목별 공격과 수비 상황에 대한 안내입니다.
SCORE
인플레이 라이브 API와 Results API 에서 Response 되는 결과 점수에 대한 안내입니다. 마켓의 결과 처리시 정규시간까지만으로 처리를 할 경우 Fulltime score 의 값으로 연장전을 포함하는 처리를 할 경우 Final score 값으로 적용하면 됩니다.
SUSPEND
인플레이 라이브 게임 API 오즈 마켓에서 사용되는 Suspend 에 대한 안내입니다. 마켓은 Suspend: 0 인 상태에서만 오픈되어야 하고 Suspend: 1 의 상태에서는 잠금 상태가 되 어야 합니다.
MARGIN CONVERTER
자체적으로 배당 값을 변경하는 사용자들을 위해 2Way, 3Way 마진 계산기를 안내합니다. 정확한 마진 변경을 위해선 반드시 True odds 값으로 변경한 뒤 조정해야만 잘못된 확률로 변경되는 오류를 범하지 않습니다. True odds 값을 구하지 않은채로 마진을 변경해버리면 마진의 확률이 함께 포함되어 변경되기 때문에 양 팀의 배당 차이가 많이 나는 경우 작은 값에도 환수율이 크게 바뀌게 됩니다.
Margin Converter [2Way]
마진 계산하려는 배당 입력
오즈 1 입력
True Odds 1
0.00
0.00%
오즈 2 입력
True Odds 2
0.00
0.00%
마진 계산 결과
북메이커 마진 결과
환수율 결과
0.00
0.00%
마진 변경 입력 및 결과
변경된 오즈 1
0.00
변경된 오즈 2
0.00
Margin Converter [3Way]
마진 계산하려는 배당 입력
오즈 1 입력
오즈 2 입력
오즈 3 입력
True Odds 1
0.00
0.00%
True Odds 2
0.00
0.00%
True Odds 3
0.00
마진 계산 결과
북메이커 마진 결과
환수율 결과
0.00
0.00%
마진 변경 입력 및 결과
변경된 오즈 1
0.00
변경된 오즈 2
0.00
변경된 오즈 3
0.00