Sportsbook API
스포츠북 데이터, 상태와 변경 이력부터 확인하세요
스포츠북 API를 검토할 때는 경기 정보와 표시값, 결과의 변화가 어떻게 전달되는지 확인해야 합니다. PLAY SOFT는 데이터의 시점과 상태를 구분해 화면 및 관리자 기록으로 연결하는 기준을 안내합니다.
Service Guide
필요한 데이터 범위를 먼저 고릅니다
스포츠북이라는 명칭만으로 제공 기능이 확정되지는 않습니다. 대상 종목과 시장 정보, 상태 변경, 결과 제공 범위를 공급사 문서에서 확인하고 프로젝트 목적에 맞게 요청 목록을 만듭니다.
Data Scope
조회 대상과 변경 규칙 정리
경기 목록과 부가 정보는 식별값을 기준으로 연결합니다. 갱신되는 값에는 반영 시각과 출처를 남기고 지원하지 않는 필드는 임의의 값으로 채우지 않도록 표시 규칙을 정합니다.
리그와 경기 목록
외부 목록이 바뀌어도 운영자가 편집한 분류와 설명이 무조건 덮어써지지 않도록 합니다. 신규·종료 항목, 이미지 누락, 코드 변경의 처리 기준을 정하고 반영 시점을 기록합니다.
배당 데이터
공급사가 제공하는 표시값에는 갱신 시각과 적용 대상을 연결합니다. 이전 값과 변경 내용을 비교할 수 있게 하고 누락되거나 오래된 응답은 최신 데이터와 구분해 안내하는 기준을 정합니다.
결과 처리
임시 결과와 확정 결과를 같은 상태로 취급하지 않습니다. 취소나 정정 통지가 들어오면 기존 기록과 새 응답을 비교할 수 있게 하고 반영 근거와 시각을 관리 화면에 남깁니다.
정산 데이터
서로 다른 출처의 수치를 비교할 때는 대상 기간과 기준 시각부터 맞춥니다. 원본 데이터와 내부 표시값의 차이를 확인할 수 있도록 하고 차이가 발생한 항목은 담당자의 확인 결과와 함께 기록합니다.
Admin Flow
변경 사항을 놓치지 않는 관리 화면
운영자는 전체 목록보다 확인이 필요한 예외를 빠르게 찾을 수 있어야 합니다. 지연 응답과 상태 변경, 결과 정정 대상을 분리해 조회하고 확인 내역을 남기는 구성을 검토합니다.
경기등록마감
상태 정의와 반영 시각을 확인해 안내 기준을 맞춥니다.
경기결과
결과의 확정 여부와 이후 변경 내용을 구분해 기록합니다.
API 상태 로그
요청 시각, 식별값, 처리 결과를 연결해 한 건의 흐름을 추적할 수 있도록 합니다. 비밀값과 불필요한 개인정보는 제외하고 보관 기간과 조회 권한을 프로젝트 기준에 맞춰 정합니다.
수동 확인 큐
확인이 필요한 예외를 모아 조치 근거와 결과를 남깁니다.
Result And Closing API
결과와 종료 상태는 별도로 검증합니다
경기가 끝났다는 상태와 결과가 최종 확정됐다는 상태는 다를 수 있습니다. 공급사의 정의를 확인하고 지연·취소·정정 데이터를 실제 화면에 어떻게 반영할지 정합니다.
자동으로 판단하기 어려운 항목은 별도 확인 대상으로 모읍니다. 담당자가 원본 응답과 처리 이력을 비교한 뒤 조치할 수 있도록 하고, 재처리 권한과 중복 실행 방지 기준도 함께 정합니다.
Integration Test
예외 사례를 검사 목록에 넣습니다
응답 순서가 뒤바뀌거나 일부 필드가 비어 있을 때도 예상한 안내가 보여야 합니다. 테스트 환경에서 지연과 중복, 취소와 재개를 확인하고 처리 근거를 기록합니다.
자동으로 판단하기 어려운 항목은 별도 확인 대상으로 모읍니다. 담당자가 원본 응답과 처리 이력을 비교한 뒤 조치할 수 있도록 하고, 재처리 권한과 중복 실행 방지 기준도 함께 정합니다.
Related Guide
데이터 연결 이후의 제작 영역
연동 검토와 함께 스포츠 화면, 운영 도구, 유지보수 계획도 살펴보세요. 기술 작업과 별도 제작이 필요한 부분을 나누면 전체 프로젝트의 범위를 정하기 쉽습니다.
Operation Guide
운영하면서 보완할 기준
실제 문의와 변경 사례를 바탕으로 검색 조건과 예외 안내를 보완할 수 있습니다. 다만 추가 기능과 공급사 변경 대응은 최초 합의 범위와 구분해 일정과 비용을 협의합니다.
외부 요청의 목적과 화면에서 사용할 정보를 대응시킵니다. 필드 변환과 상태 표시, 실패 안내를 각각 정하고 연결 성공 여부를 실제 응답 및 테스트 기록으로 확인합니다.
FAQ
스포츠북 연동 검토 질문
스포츠북 데이터 검토에 필요한 자료는 무엇인가요?
대상 종목과 데이터 종류, 요청 문서, 상태 정의, 갱신 조건을 준비해 주세요. 정상·오류 응답 예시와 테스트 권한 유무도 함께 알려주시면 좋습니다.
일반 스포츠 API와 스포츠북 API를 어떻게 구분하나요?
명칭보다 제공 필드로 구분하는 편이 정확합니다. 경기 기본 정보 외에 어떤 시장 정보와 표시값, 마감·결과 상태를 지원하는지 문서에서 확인하세요.
변동하는 표시값은 무엇을 기준으로 검증하나요?
적용 대상과 갱신 시각이 맞는지, 이전 값과 변경 내용을 추적할 수 있는지 확인합니다. 늦게 도착한 응답이 최신 값을 덮어쓰지 않는지도 시험합니다.
결과가 제때 들어오지 않으면 무엇을 확인하나요?
경기 상태와 마지막 정상 요청, 공급사의 응답을 순서대로 확인합니다. 결과 미수신과 미확정을 구분해 표시하고 담당자가 확인한 내용과 후속 조치를 기록합니다.
Contact
확인할 공급 자료를 보내주세요
대상 데이터와 공급사 문서 유무를 @PLAYSOL8로 알려주세요. PLAY SOFT가 연결 범위와 운영 확인 항목을 함께 정리합니다.