---
title: "GAMEPOT 3.0 개요"
slug: "gamepot-overview"
tags: ["Classic", "GAMEPOT", "VPC"]
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/gamepot-overview"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GAMEPOT 3.0 개요

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 개요](/docs/game-gamepot)를 참조해 주십시오.

## 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 응답 상태 코드](/docs/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

#### 응답 예시

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

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

## GAMEPOT 3.0 API

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

| API | 설명 |
| --- | --- |
| [사용자 이용 정지](/docs/gamepot-postmemberblock) | 지정한 사용자의 게임 이용 정지 실행 |
| [푸시 발송](/docs/gamepot-postpush) | 푸시 알림 메시지 즉시 또는 예약 발송 |
| [고객 지원 공지 목록 조회](/docs/gamepot-getcsnoticelist) | 고객 지원 화면의 공지 목록 조회 |
| [고객 지원 공지 조회](/docs/gamepot-getcsnotice) | 고객 지원 화면의 공지 조회 |
| [공지 사항 목록 조회](/docs/gamepot-getnoticelist) | 공지 사항 목록 조회 |
| [공지 사항 조회](/docs/gamepot-getnotice) | 공지 사항 조회 |
| [사용자 연동 정보 조회](/docs/gamepot-getintegrationinfo) | 사용자의 계정 연동 정보 조회 |
| [사용자 이용 정지 목록 조회](/docs/gamepot-getmemberblocklist) | 이용 정지된 사용자 목록 조회 |
| [사용자 조회](/docs/gamepot-getuserinfo) | 사용자 상세 정보 조회 |
| [플레이어 목록 조회](/docs/gamepot-getplayerlist) | 게임 플레이어 목록 조회 |

## GAMEPOT 3.0 연관 리소스

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

- GAMEPOT 3.0 API 사용 방법
  - [Ncloud 공통 응답 상태 코드](/docs/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): GAMEPOT 3.0 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- GAMEPOT 3.0 서비스 사용 방법
  - [GAMEPOT 3.0 사용 가이드](https://guide.ncloud-docs.com/docs/game-gamepot-overview): 네이버 클라우드 플랫폼 콘솔에서 GAMEPOT 3.0 서비스를 사용하는 방법
  - [Ncloud 사용 환경 가이드](https://guide.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 대한 가이드
  - [요금 소개, 특징, 상세 기능](https://www.ncloud.com/product/game/gamepot): GAMEPOT 3.0의 요금 체계, 특징, 상세 기능 요약
  - [서비스 최신 소식](https://www.ncloud.com/intro/news?categoryCode=GAME&serviceCode=SV_0103): GAMEPOT 3.0 서비스 관련 최신 소식
  - [자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=GAME&categoryCode3=SV_0103&page=1): GAMEPOT 3.0 서비스 사용자들이 자주 하는 질문
  - [문의하기](https://www.ncloud.com/support/question/service): API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의