Our APIs

테스트 API 요청 방법


테스트 API는 Contact 메뉴의 테스트 API 에서 신청할 수 있습니다. 양식에서 업체명, 텔레그램id, 호출 IP 주소를 입력하여 평일 오전 10시부터 오후 7시사이 제출하면 가입시 등록한 이메일로 세팅완료후 결과를 회신합니다. 근무시간 이외의 시간에 요청한 경우 다음 근무일에 세팅됩니다. 테스트 API 신청시 반드시 이용방법을 필독하시고 요청하시기 바랍니다.




이용문의 안내


오즈호스트 API에 처음 방문하셨다면 Contact 에서 이용문의를 하실 수 있습니다. 이용문의는 서비스 이용과 관련한 일반적인 모든 문의가 가능하며 평일 오전 10시부터 오후 7시안에 제출된 경우 바로 답변 받을 수 있고 이후 시간대 접수된 문의는 다음 근무일에 처리됩니다. 답변은 가입시 등록한 이메일(로그인id)로 회신됩니다. 이용문의시 중복된 질문을 작성한 경우 최초 접수된 질문에만 회신하며 추가 질문에는 답변하지 않으며 회원 가입시 "홍길동, 테스트, asdf" 등의 무성의한 허위 정보로 가입한 경우 그 어떤 문의에도 답변하지 않습니다.




결제 수단에 따른 환율 고지 안내


계좌이체 결제는 주문 요청후 원화 고지금액 그대로 결제가 청구됩니다. 신용카드 결제는 주문 요청후 고지된 금액을 결제하면 해외 결제로 승인을 요청하며 USD(미화)로 결제가 진행됩니다. USD 결제시 카드사에서 해외 결제 수수료가 발생할 수 있으며 카드사마다 차이가 있으나 KRW 1백만원기준 약 5,000원의 해외 결제 수수료가 발생합니다. 페이팔 결제는 주문 요청후 원화로 고지된 금액을 AUD(호주달러)로 변환하여 결제가 청구되며 환율 레이트는 주문요청이 접수된 시점에서 전세계 환율 공식 사이트인 미국의 OANDA 를 통해 환산합니다. 가상화폐 XRP(리플) 결제는 주문 요청후 원화로 고지된 금액을 XRP 수량으로 환산하여 결제 수량을 청구하며 환전 레이트는 암호화폐 환율 전망 대행사 의 실시간 리플 변환기를 통해 환산합니다. 신용카드를 제외한 계좌이체, 페이팔, 가상화폐 결제는 주문후 주문을 요청한 사용자의 이메일로 결제 계좌 및 금액을 발송합니다. 모든 주문은 결제요청후 3시간내에 결제 완료되어야 주문이 실행되며 결제 처리가 되지 않을시 접수된 주문은 취소처리 됩니다. 지속적으로 주문 취소가 발생하는 사용자는 아이피와 로그인 이메일을 차단합니다.




API 제공 방식


오즈호스트 API는 게이트웨이 서버를 통해 API 호출이 들어오면 호출이 정확한지, 인증된 사용자의 호출인지, 리퀘스트 파라미터가 누락되지 않았는지 등을 확인한 다음 API 서버를 호출한 결괏값을 JSON 형태로 출력하며 잘못된 호출에는 오류 코드를 반환합니다. 오즈호스트에서 제공하는 API를 RESTful API 방식으로 호출할 수 있습니다.




자동결제(신용카드) 등록 방법


결제 방법에서 신용/체크카드로 결제를 진행한 경우 결제한 카드를 등록하여 다음 결제시 카드 입력 없이 바로 결제하실 수 있습니다. 신용/체크카드는 비자, 마스터 등 모든 카드를 지원하지만 South Korea 기준으로 해외 결제가 가능한 카드만 결제할 수 있으며 오즈호스트는 South Korea에 지점이 없기 때문에 승인되는 카드사의 결제는 해외 결제로 진행됩니다.




멤버십 권한 안내


Member Only 메뉴는 유료 회원에게만 제공 됩니다. 업데이트 로그 - API 업데이트 히스토리를 안내합니다.
API 가이드 - API 사용 가이드 입니다.
자주하는 질문 - 기술 질문에 관한 FAQ 정리 내용입니다.
서포트 문의 - 서포트팀으로 기술 문의를 하는 회원 전용 문의란 입니다.




법인 비용처리 안내


오즈호스트는 South Korea에 지점이 없어서 세금 계산서 발행 및 비용처리가 불가합니다. 법인회사의 경우 신용카드 결제나 가상화폐 결제로 비용처리를 받으실 수 있습니다.




인보이스 발행 안내


결제를 완료하면 인쇄가 가능한 전자 인보이스 발행이 가능합니다. 인보이스를 원하시는 경우 제품 주문시 선택사항에서 인보이스 발행 선택을 "예"로 선택하시기 바랍니다.




텔레그램 채널 안내


오즈호스트는 당사의 이용 고객들을 위해 텔레그램 채널을 운영합니다. 텔레그램 채널은 API 이용시 서포트팀에서 바로 초대를 진행하며 이용자가 수락하면 입장할 수 있습니다. 당사의 로우데이터나 서버에 이상유무가 발생한다면 고객사에서 즉각적인 조취를 취할 수 있도록 안내하는 채널로 API와 관련된 점검, 변경, 수정, 장애처리, 서버 이상유무, 업데이트 내용 등을 실시간 공지하여 고객이 이용중인 데이터에 문제가 없도록 안내 합니다.




서포트 문의 안내


서포트 문의는 API 이용시 가능하며 회원전용 페이지에서 이용할 수 있습니다. 서포트팀 전용 문의 게시판을 운영하며 간편문의, 상세문의, IP변경요청 등으로 세분화되어 최대 30분내외로 답변처리를 합니다. 서포트팀 운영 시간은 오전 10시 전후에서 오후 7시 전후까지 비교적 탄력적으로 응대하며 긴급장애 발생시 24시간 장애신고를 받고 처리 합니다. 또한 서포트팀 전용의 텔레그램 채널을 운영하여 중요 공지사항 및 업데이트 안내를 받으실 수 있습니다.




결제 방법 안내


결제방법 상세안내는 Order/Pay 상품 상세 정보 보기 에서 확인할 수 있습니다. 오즈호스트에서 제공하는 페이먼트 수단은 아래와 같습니다. 신용/체크카드 - 홈페이지에서 바로 결제 가능 계좌이체 - 결제요청시 이메일로 결제 안내 페이팔(Paypal) - 결제요청시 이메일로 결제 안내 가상화폐 - 결제요청시 이메일로 결제 안내




계약서 요청 안내


오즈호스트의 API 상품은 이용자가 디지털 콘텐츠를 구매하는 방식으로 계약을 통해 계약된 기간동안 상호 의무를 수행하는것이 아니기에 계약서를 취급하지 않습니다. 계약서를 작성하진 않지만 전자 인보이스 발행은 가능합니다.




제공 데이터 한글 번역 안내


전체 카테고리의 종목명, 지역명, 리그명, 팀명, 배당 마켓명은 한글로 완벽 번역 되어 있습니다. 팀명의 경우 개별 종목에 따라 번역차이가 있으나 번역 완성도 높은 수준입니다. 단사이버 이스포츠류의 항목과 플레이어 이름의 경우는 종목 특성상 한글번역을 하지 않습니다.




개인정보 수집 안내


API 사용시 아래의 항목들을 요청하여 수집합니다. 이름 또는 회사명: 서비스 이용자명 등록 텔레그램 ID: 긴급 연락 및 업데이트 로그 공지 채널 초대, 고객사의 개발 담당자 id 필요 이메일 주소: 문의, 요청, 주문, 결제, 인보이스 발행 등의 수단 IP주소: API 호출을 허용하기위한 보안 수단 위의 항목들은 재결제 구매가 이루어지지 않게되면 1개월 후 모두 삭제처리 됩니다. 자세한 개인정보 수집 안내는 홈페이지 하단 Privacy Policy 에서 확인할 수 있습니다.




API 주문 방법


테스트 API와 사용을 위한 결제 세팅 요청 모두 홈페이지를 통해서 가능합니다. 오즈호스트는 고객의 세팅 요청이 발생하면 자동적으로 오토메이션 업무처리가 발동되며 담당 CS직원이 고객의 요청을 수락하여 처리합니다.

  1. 결제 수단 선택: 주문후 결제를 진행할 결제 수단을 선택해 주세요. 매월 결제시 변경 가능합니다.
  2. 인보이스 발행 선택: 결제 완료후 인쇄가 가능한 인보이스 발행이 가능합니다.
  3. 사용자 IP 입력: 오즈호스트의 API를 호출할 사용자의 IP주소를 입력하세요. 이용시 주1회 변경 가능합니다.
  4. 텔레그램 ID 입력: 업데이트 로그를 안내하는 텔레그램 채널에 초대할 고객님의 개발자 ID를 입력해 주세요. 이용시 변경 가능합니다.
  5. 수량: 기본수량 1은 1개월 제공을 뜻합니다.
  6. 카트에 추가: 장바구니에 담아서 다른 상품들과 한번에 결제할 수 있습니다.
  7. 주문하기: 위에 입력한 내용을 갖고 주문을 진행합니다.




한 고객사에서 2계정 이상 가입하는 경우 안내


한 고객사에서 2계정 이상 가입하는 경우에는 가입시 반드시 동일한 고객사명을 입력해주시고 아래와같이 고객사명 뒤에 "개발" 등의 담당 업무를 적어서 가입해 주세요. 예) 업체명 - 홍길동
첫번째 가입계정 업체명 - 홍길동
두번째 가입계정 업체명 - 홍길동 (개발) 서포트 1:1 Q&A는 고객사의 개발자분만 문의 하시는게 좋으며 이 경우 고객사 이름이 같지 않으면 문의나 요청에 대한 피드백이 진행되지 않을 수 있습니다.




오즈호스트 안내


오즈호스트 API는 2012년 창립 이래 지금까지 방대하고 다양한 오즈 데이터를 고객의 플랫폼에 가장 빠르고 정확한 방식으로 제공하는 것을 목표로 성장해 왔습니다. OddsHost API는 전 세계 어디에서도 제공 불가능한 독보적인 오즈 데이터들을 단일 통합하여 서비스하며 우리의 고객들에게 질적이고 창의적으로 혁신적인 API를 서비스합니다. 오즈호스트 API는 온라인 북메이커 시장에서 성공적인 비즈니스를 구축하고 성장시키는 데 대한 모든 지식을 알고 있으며 우리의 고객들이 어려운 기술과 복잡한 지식 없이도 성공적인 솔루션을 개발할 수 있도록 가이드 합니다.




프리매치와 인플레이의 차이 안내


프리매치는 경기 시작전 ​오즈 마켓이 오픈되고 경기가 진행되면 오즈 마켓이 닫히며 인플레이는 경기 진행중 상황에서 오즈 마켓이 오픈되고 닫히는 것을 말합니다. 프리매치 = 경기전 마켓 ​인플레이 = 라이브 마켓 스포츠 매치는 1.경기전 - 2.경기중 - 3.경기종료 순으로 게임이 진행됩니다. 프리매치는 1번 상황에서 마켓이 오픈되고 2번 상황에서 마켓이 종료되며 3번 상황에서 결과가 제공됩니다. 인플레이는 2번 상황에서 실시간으로 마켓이 오픈되고 종료됩니다. 프리매치 오즈는 1쿼터, 2쿼터, 3쿼터, 4쿼터 마켓이 있어도 실시간적으로 마켓이 오픈되는 것이 아닌 1번 상황에서 모든 마켓이 오픈되었다가 2번 상황과 동시에 모든 마켓이 닫힙니다. 경기의 상황에 따라 마켓이 오픈되고 닫히며 배당의 변하는 것은 인플레이를 뜻합니다. 인플레이는 경기가 진행되는 상황 자체가 결과값이기 때문에 실시간 결과처리가 가능하지만 프리매치는 라이브 상황이 없기에 경기가 종료되어야만 결과값이 생성되는 불편함이 있습니다. 또한 리그의 퀄리티가 낮은 하부 리그일수록 결과값 발생이 1시간 이상 걸리기도 합니다. 오즈호스트 API는 프리매치에서 결과가 늦어지는 불편함을 개선하기 위해 프리매치 결과처리를 라이브 인플레이와 연동해서 제공합니다. 오즈호스트 프리매치 API를 이용하게 되면 라이브 결과로 실시간 결과처리가 가능합니다.




영구적인 이용 제한자에 대한 주문요청 거부 권리 고지


오즈호스트 API는 영구적인 이용 제한자를 규정하여 서비스 주문요청시 거부할 권리를 가지며 당사의 운영에 피해를 주는 행위를 할 경우 피해 보상에 대해 강력한 법적 조치를 대응함을 고지합니다.

  1. 대포통장 결제 및 계좌사고를 유발하는 행위
  2. 오즈호스트에서 API를 제공받아 동일한 제공 서비스를 모방하는 행위
  3. 사칭 사기 비방 비매너 행위
  4. 악의적인 이용문의를 지속적으로 보내는 행위
  5. 3개월 이내에 2번이상의 환불 요청을 하거나 무료제공 요청을 반복적으로 하는 행위




환불고지 안내


오즈호스트 API 구매자는 결제 완료 후 또는 재결제 이후 3일(72시간) 이내에 환불을 요청할 수 있으며 사용일로부터 3일이 초과되면 환불 요청이 불가능합니다. 오즈호스트의 API 대금 결제는 제공 일자를 기준으로한 선불 결제 개념이 아닌 정해진 기간동안 API를 호출할수 있는 권한을 구매하는 방식으로 정보 이용에 대한 일회성 결제입니다. 고객은 세팅된 API를 호출하는 시점부터 구매 정보를 사용하여 제품 구매를 확정한것으로 간주하지만 구매 이후에 충분한 확인 시간을 제공하기 위해 환불을 결정할 수 있는 유해기간을 3일간 적용합니다. 환불은 결제한 금액에서 API 세팅에 사용된 서버 이용료 20만원을 차감한뒤 전액 환불되며 반드시 결제한 수단으로만 환불이 처리되며 계좌이체시에는 입금했던 계좌가 아닌경우 환불요청이 반려되며 환불 승인후 3일 이후에 처리가 진행됩니다. 3개월 이내에 2번 이상의 환불을 요청한 고객의 경우 불순한 목적으로 이용한것으로 간주하여 오즈호스트는 해당 회원을 영구적인 이용 제한자로 등록하며 해당 유저가 등록했던 아이디, 아이피, 이메일, 로그도 영구적인 사용제한 조치를 진행합니다. 환불 요청은 1000분의 1정도로 극히 드문 경우지만 양사모두에게 달가운 절차가 아니니 무료로 제공되는 테스트 피드와 오픈된 API 가이드 문서 등을 통해 사전에 충분히 검토하신 뒤 신중한 거래를 진행해 주시기 바랍니다.





© 2020 API Hosting Corp. All Right Reserved.

  • OddsHost Twitter