FELTLINE

게임·데이터 연동

스포츠북 데이터 연동과 경기 결과 정정

경기 일정, 배당 버전, 연기와 공식 결과를 거래 당시의 기록에 연결하는 스포츠 데이터 연동 가이드입니다.

본문 읽기 도입 검토서 작성
스포츠북 운영 데모 보기

경기 일정을 거래와 연결하는 식별자

스포츠 데이터 연동에서 운영팀이 먼저 결정할 값은 경기 이름을 표시하는 방법과 같은 경기를 계속 추적하는 식별자입니다. 두 팀 이름과 날짜가 같아도 리그, 경기 차수, 홈·원정 구분이 다를 수 있습니다. 경기 시간이 바뀌어도 원래 접수 기록이 새 경기로 잘못 연결되지 않도록 공급사 경기 키와 내부 경기 키의 관계를 정합니다.

경기 목록은 일정을 중심으로 갱신하고 회원 접수 내역은 접수 당시의 정보를 보존합니다. 오전에 ‘20시 시작’이라고 표시했는데 18시에 시작 시간이 21시로 밀린 사례를 만들어 보세요. 새 목록에는 21시가 보이고, 이전 접수 상세에는 접수 시각과 당시 경기 정보가 남으며 변경된 일정을 함께 조회할 수 있으면 운영자가 회원에게 변경 경위를 설명할 수 있습니다.

배당 버전을 보존하는 이유

배당 값은 접수 전까지 여러 차례 갱신될 수 있습니다. 회원이 본 화면의 값과 접수 승인이 난 값이 같았는지 확인하려면 접수 당시의 배당 버전과 승인 시각이 필요합니다. 최신 피드 값 하나로 지난 거래 상세를 채우면 공급사가 뒤에서 값을 바꿨을 때 원래 조건을 알아볼 수 없습니다.

일정 예시스포츠 목록에 표시할 값기존 회원 접수에 남길 값
18시 00분 경기 등록경기 키, 리그, 시작 예정 시각아직 접수 기록 없음
18시 10분 배당 버전 3버전 3과 최근 갱신 시각이때 접수한 회원은 승인 버전 3
18시 12분 배당 버전 4갱신된 현재 배당버전 3으로 받은 기존 거래 유지
19시 59분 경기 연기경기 상태와 변경 일정원래 접수와 결과 대기 상태 연결

피드가 끊긴 상태에서 오래된 값을 최신처럼 표시하면 운영자가 잘못 판단할 수 있습니다. 팀이 정한 수신 유효 기간을 넘겼을 때 표시 방식, 신규 접수 제한, 복구 후 첫 정상 버전을 확인하는 절차를 요구사항으로 정합니다. 수신 유효 기간은 종목과 계약에 따라 다르므로 예시 시간만으로 모든 리그의 운영 기준을 고정하지 않습니다.

경기 연기, 중단, 취소는 별도 상태

시작 전 연기는 새 일정이 잡힐 때까지 기존 접수가 대기할 수 있습니다. 진행 도중 중단은 이미 발생한 일부 결과를 어떻게 취급할지가 종목 규칙과 계약 조건에 따라 달라질 수 있습니다. 완전 취소는 공급사가 정한 공식 처리와 지갑 반환을 확인해야 합니다. 화면에서 셋 모두 ‘경기 미진행’으로 묶으면 운영 담당자가 어떤 거래를 어느 시점에 마감해야 하는지 알기 어렵습니다.

특히 상태 피드가 연기 직후 다시 예정으로 바뀐 경우를 시험해 보세요. 원래의 연기 수신 시각을 지우지 않고 새 상태의 버전을 추가해야 변경 이력을 볼 수 있습니다. 예전 버전이 늦게 도착하면 현재 일정을 과거 시각으로 되돌리지 않는지도 검수합니다. 공급사가 버전 번호를 주지 않을 때는 어떤 순서 근거를 사용할지 테스트 자료로 확인합니다.

공식 결과의 사후 정정

종료 통지가 들어오고 공식 결과가 확정된 뒤에도 사후 정정이 생길 수 있습니다. 최초 결과, 최초 지급, 수정 결과와 수정 지급 간의 연결을 보존하는 것이 정산팀의 검수 기준입니다. 이미 지급한 기록을 덮으면 이전에 만든 보고서와 회원 문의 시점의 상태를 설명하기 어렵습니다.

예를 들어 최초 지급 21,000P 중 공급사의 수정 결과에 따라 3,000P를 줄이는 정책을 검토합니다. 운영 화면에서는 최초 +21,000P와 정정 -3,000P가 각각 보이고, 최종 지급 합계는 18,000P입니다. 정정에 승인이 필요한 계약이라면 승인되기 전에는 최종 원장 금액이 바뀌지 않아야 합니다. 회원의 가용 금액이 정정액보다 작은 사례에 대한 상태와 후속 절차도 계약에서 확인합니다.

리그 하나로 공급 범위 검증하기

  • 시즌 전에 생성한 리그와 경기 목록에서 실제 운영할 리그 키를 찾습니다. 한글 표시 이름이 다른 제공처의 자료와 어떻게 매핑되는지 확인합니다.
  • 같은 경기에서 프리매치 배당을 두 차례 갱신하고 회원이 접수한 버전을 저장합니다. 최신 화면과 기존 접수 기록을 따로 비교합니다.
  • 일정 변경, 중단, 취소의 샘플을 하나씩 확보합니다. 상태별 회원 안내와 확정되지 않은 금액의 처리 기준을 운영표에 적습니다.
  • 결과가 자정 이후에 들어온 거래를 조회합니다. 공급사 원본 시간대, 한국 화면 시간대와 정산일을 대조합니다.
  • 사후 정정 시 한 번 마감한 보고서를 다시 생성하는지 별도 정정표가 생기는지 확인합니다. 이전 보고서와 차이를 설명할 거래 번호를 검수 자료에 남깁니다.

여러 공급사의 같은 경기를 받을 때

일정을 주는 공급사와 공식 결과를 주는 공급사가 다르면 한쪽의 경기 키만으로 연결하기 어려울 수 있습니다. 리그와 팀 이름 매핑, 경기 시간 변경 이력, 중복 경기 후보를 검토하는 절차가 필요합니다. 새 시즌이나 컵대회에서 평소와 다른 팀 약칭이 들어온 자료를 표본으로 요청하면 자동 연결이 불확실한 경우의 처리 방법을 볼 수 있습니다.

두 공급사의 결과가 다를 때는 먼저 계약상 확정 근거를 선택하고 운영 화면에 출처를 남깁니다. 이후 재수신과 정정 요청에서 어느 출처를 확인했는지 기록해 담당자가 바뀌어도 같은 원칙을 따를 수 있게 하세요. 이 표본 한 건으로 콘텐츠 팀은 경기 상태를, 정산 팀은 원장 변화를, 상담 팀은 회원 안내 문구를 각각 검수할 수 있습니다.