Slot API Guide
슬롯 콘텐츠 API 검토 노트
슬롯 콘텐츠 API는 제공 항목과 갱신 방식, 현재 상태를 이해하는 데서 검토가 시작됩니다. PLAY SOFT는 정식 이용 조건과 문서, 응답 예시를 바탕으로 목록 표시와 관리 도구의 범위를 정리합니다. 연결 전에 확인할 항목을 단계별로 살펴보세요.
API 상담 기준
연결을 시작하기 전 알아둘 것
정식 이용 권한과 문서 버전, 제공 데이터 범위를 먼저 확인합니다. 화면에 필요한 항목과 실제 응답을 대조해 검토 범위를 정합니다.
Provider Standard
공급사 자료를 읽는 방법
목록과 분류, 인증 조건, 제공 상태, 갱신 제한을 확인합니다. 문서만으로 불분명한 동작은 샘플과 시험 환경으로 검토합니다.
콘텐츠를 사용할 수 있는 지역과 권한, 이용 기간도 확인해야 합니다. 문서에 없는 동작은 추정하지 않고 공급사의 확인 자료를 바탕으로 검토합니다.
Technical Scope
API를 화면에 반영하는 범위
접근 방식과 권한
인증 방식과 허용 환경을 문서에서 확인합니다. 인증정보가 화면이나 로그에 노출되지 않도록 접근 범위를 설계합니다.
목록과 분류 체계
식별자와 이름, 공급사, 카테고리를 일관되게 연결합니다. 누락된 이미지와 빈 분류의 표시도 정합니다.
콘텐츠 연결 상태
제공 가능 여부와 점검 상태를 구분합니다. 잘못된 목적지나 접근 실패의 안내를 함께 검토합니다.
실패했을 때의 안내
지연과 접근 실패, 없는 항목을 구분합니다. 재확인에 필요한 정보와 안내 문구를 정합니다.
Sync Flow
목록 갱신에서 표시 확인까지
기준 목록과 갱신 결과를 비교해 추가·수정·미제공 항목을 구분합니다. 반영한 분류와 이미지, 제공 상태를 화면에서 확인합니다.
일부 요청이 실패했을 때 이전 목록을 어떻게 유지할지 정해두세요. 최신 상태와 마지막 확인 시각을 구분하면 불완전한 갱신을 정상 완료로 오해하는 일을 줄일 수 있습니다.
갱신 전 준비
- 공급사 테스트 계정 확인
- 게임 목록 샘플 수집
- 필수 필드와 선택 필드 분리
- 카테고리 매핑 기준 작성
- 썸네일 누락 대응 기준
갱신 과정 확인
- 신규 게임 추가 감지
- 삭제 또는 중단 게임 처리
- 점검 상태 반영
- 인기 게임 수동 고정
- 마지막 동기화 시간 저장
연결 화면 확인
- PC와 모바일 실행 확인
- 세션 만료 메시지 확인
- 리턴 URL 동작 확인
- 점검 게임 접근 차단
- 오류 로그 관리자 표시
Admin Checklist
관리 화면에서 살펴볼 데이터
목록 편집과 제공 상태, 갱신 결과를 확인하도록 구성합니다. 필요한 변경 이력과 검토 절차도 정합니다.
목록 편집 도구
- 공급사별 게임 목록
- 카테고리와 인기 게임 설정
- 게임별 노출 ON/OFF
- 썸네일과 이름 수동 보정
- 신규 게임 반영 이력
현재 상태와 변경 기록
- 공급사 점검 상태
- 최근 API 요청 시간
- 실패 응답 코드와 메시지
- 게임 실행 실패 내역
- 재시도와 처리 상태
반영 확인 절차
- 테스트 계정 실행 확인
- 모바일 화면 전환 확인
- 목록 동기화와 수동 보정 확인
- 점검 상태 사용자 노출 확인
- API 변경 대응 절차 정리
Estimate Detail
연동 작업량을 판단하는 기준
공급사 수, 문서 차이, 시험 환경, 관리 도구를 함께 봅니다. 외부 이용료와 연결 작업은 구분해 비용을 협의합니다.
각 공급사의 차이
같은 필드명도 의미가 다를 수 있습니다. 공통 표시 기준과 개별 예외를 나누어 검토합니다.
명세와 시험 환경
문서 버전과 응답 예시, 시험 조건을 확인합니다. 검증할 수 없는 항목은 추가 확인 대상으로 남깁니다.
관리 도구 설계
목록 검색과 편집, 상태와 기록 중 필요한 메뉴를 고릅니다. 역할별 권한에 따라 범위를 정합니다.
변경 대응 계획
공급사 공지를 누가 확인할지 정합니다. 정기 점검과 새 연동을 구분해 관리 범위를 협의합니다.
Related Guides
데이터 연결 참고 문서
Request Example
API 검토 요청에 담을 내용
공급사 문서와 적용 기능, 현재 화면 구조를 알려주세요. 민감한 값을 제거한 응답 예시와 필요한 표시 항목을 함께 준비합니다.
문서의 적용 버전과 시험할 수 있는 환경도 함께 알려주세요. 인증키나 비밀번호 대신 민감한 값을 제거한 응답 예시를 사용하면 필요한 구조를 안전하게 설명할 수 있습니다.
Slot API FAQ
슬롯 API 검토 Q&A
슬롯 콘텐츠 API 검토의 출발점은 무엇인가요?
정식 이용 권한과 적용할 문서 버전을 확인하세요. 필요한 목록 항목, 응답 예시, 시험 환경을 정리한 뒤 표시 화면의 범위를 검토합니다.
콘텐츠 목록 갱신은 무엇을 확인해야 하나요?
공급사가 제공하는 갱신 방식과 제한 조건부터 살펴봐야 합니다. 추가, 수정, 미제공 항목을 구분하고 갱신이 실패했을 때의 안내도 설계하세요.
연결 문제를 설명할 때 어떤 기록이 필요한가요?
발생 시각, 대상 화면, 오류 코드, 재현 순서를 남겨주세요. 인증키와 개인 정보가 포함된 원문은 전달하지 말고 민감한 값을 제거한 예시를 사용해야 합니다.
Contact
문서에서 실제 확인 항목을 찾아보세요
사용할 콘텐츠와 공급사 문서, 관리 화면 요구를 전달해주세요. 목록과 갱신, 상태 안내를 나누어 검토합니다.