GAMEPOT 3.0 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

GAMEPOT 3.0은 게임을 개발, 서비스, 운영하는 데 필요한 기능을 통합하여 제공하는 네이버 클라우드 플랫폼의 서비스입니다. GAMEPOT 3.0 서비스에서는 게임 사용자 관리에 필요한 여러 기능을 RESTful API 형태로 제공합니다.

GAMEPOT 버전

GAMEPOT은 GAMEPOT 2.0.과 GAMEPOT 3.0이 제공됩니다. 각 버전에 대한 설명은 다음과 같습니다.

구분 설명
GAMEPOT 2.0 게임 개발 및 운영을 위한 다양한 기능을 제공하는 서비스로, 게임 개발자들이 효율적으로 게임을 개발하고 관리할 수 있도록 지원
  • 고급 사용자 통계 및 동시 접속 사용자 관리 기능
  • 운영 및 관리에 용이한 대시보드
  • 다양한 로그인 연동 기능 (구글, 애플, 페이스북, 라인 등)
  • 다양한 스토어와의 연동 기능
  • 다양한 플랫폼 지원 (Android, iOS, Unity, Unreal, JavaScript)
  • 구현이 쉬운 결제 기능
GAMEPOT 3.0 GAMEPOT 2.0의 필수 기능을 확장하고 개선한 버전으로, 게임 개발 및 운영에 필요한 모든 기능을 모듈별로 제공
  • 모듈별 기능 제공으로 필요한 기능 연동 용이
  • repository, cocoapods 형태로 제공되는 간편화된 개발 환경 연동
  • 개선된 대시보드를 통한 게임 통계 및 관리 기능
  • 다양한 로그인 연동 기능(구글, 애플, 페이스북, 라인, 스팀 등)
  • 다양한 스토어와의 연동 기능
  • 구현이 쉬운 결제 기능
  • 플러그인 기능을 통한 확장성
참고

GAMEPOT 2.0 API를 사용하려면 GAMEPOT 2.0 개요를 참조해 주십시오.

GAMEPOT 3.0 공통 설정

GAMEPOT 3.0 API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://dashboard-api.gamepot.ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-api-key Required GAMEPOT 3.0용 API 키
  • GAMEPOT 3.0 대시보드의 프로젝트 설정 > API Key에서 [추가] 버튼 클릭하여 발급
    • 설정한 만료일까지 유효
x-project-id Required GAMEPOT 3.0 프로젝트 아이디
  • GAMEPOT 3.0 대시보드의 프로젝트 설정 > 일반에서 확인
Content-Type Required 요청 데이터의 형식
  • application/json
Accept Required 응답 데이터의 형식
  • application/json

응답

공통 응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

Error
Error는 API 호출 실패 정보를 정의합니다. Error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
status Integer - 응답 코드
message String - 오류 메시지

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
- 1 - 응답 성공
- -1 -
  • 등록되지 않은 API 키 입력
  • 접근 권한 없음
- -2 - 대시보드의 API 키와 헤더에 입력한 API 키 상이
- -3 - 삭제된 API 키
- -4 - 대시보드에서 미사용 처리된 API 키
- -5 - 만료된 API 키
- -6 - 존재하지 않는 프로젝트 아이디
- -9 - 필수 헤더 누락
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

{
  "status": -6,
  "message": "projectId was wrong."
}

GAMEPOT 3.0 API

GAMEPOT 3.0 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
사용자 이용 정지 지정한 사용자의 게임 이용 정지 실행
푸시 발송 푸시 알림 메시지 즉시 또는 예약 발송
고객 지원 공지 목록 조회 고객 지원 화면의 공지 목록 조회
고객 지원 공지 조회 고객 지원 화면의 공지 조회
공지 사항 목록 조회 공지 사항 목록 조회
공지 사항 조회 공지 사항 조회
사용자 연동 정보 조회 사용자의 계정 연동 정보 조회
사용자 이용 정지 목록 조회 이용 정지된 사용자 목록 조회
사용자 조회 사용자 상세 정보 조회
플레이어 목록 조회 게임 플레이어 목록 조회

GAMEPOT 3.0 연관 리소스

GAMEPOT 3.0 API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.