---
title: "リーダーボード"
slug: "game-gamepot-leaderboard"
updated: 2026-09-17T09:57:53Z
published: 2026-09-17T09:57:53Z
canonical: "api.ncloud-docs.com/game-gamepot-leaderboard"
---

> ## 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.

# リーダーボード

## リーダーボード API

## リーダーボードユーザースコア登録 API

#### Request

- Method : POST
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs

```
POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "leaderboardId" : "leaderboardId",
    "userId" : "70045665-f64a-45c0-xxxx-xxxxxxxxx",
    "score": 10,
    "subscore": 0,
    "metadata": "{\"key\":\"value\"}"
}
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | O | ダッシュボードで作成したリーダーボード固有 ID |
| userId | String | O | ユーザー ID |
| score | Integer | X | スコア |
| subscore | Integer | X | サブスコア(必須でない) |
| metadata | String | X | 追加情報 |

#### Response

成功

```
{
   "leaderboardlog": {
        "project_id": "ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx",
        "id": "TGVhZGVyYm9hcmRMb2c6NjNkMzRhYTgxxxxxxxxx",
        "user_id": "70045665-f64a-45c0-xxxx-xxxxxxxxx",
        "score": 10,
        "subscore": 0,
        "metadata": "{\"key\":\"value\"}",
        "expiredAt": "2023-01-30T20:00:00-08:00"
    }
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (-1 失敗) |
| message | String | エラーメッセージ |
| leaderboardlog.project_id | String | プロジェクト ID |
| leaderboardlog.id | String | 入力 ID |
| leaderboardlog.user_id | String | ユーザー ID |
| leaderboardlog.score | Int | スコア |
| leaderboardlog.subscore | Int | サブスコア |
| leaderboardlog.metadata | Int | ユーザー定義データ |
| leaderboardlog.expiredAt | String | 満了日 |

失敗

```
{
    "status": -1,
    "message": "登録失敗"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| code | Int | 結果値 (1: 成功、失敗時 Error code参照) |
| error | String | エラー内容 |

## リーダーボードユーザースコア取得 API

#### Request

- Method : GET
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs

```
GET
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "leaderboardId" : "leaderboardId",
    "offset": 0,
    "per_page": 20
}
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | O | ダッシュボードで作成したリーダーボード固有 ID |
| offset | Integer | X | OFFSET |
| per_page | Integer | X | LIMIT |

#### Response

成功

```
[
    {
        "rank": 1,
        "leaderboard_id": "leaderboardId",
        "user_id": "9c510599-f77a-4e3e-xxxxxx-xxxxxxx",
         "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxxxxxxx",
        "score": 1100,
        "subscore": 0,
        "metadata": "{\"key\":\"value\"}",
        "expiredAt": "2023-01-30T20:00:00-08:00",
        "updatedAt": "2023-01-26T19:46:07-08:00"
    },
    {
        "rank": 2,
        "leaderboard_id": "leaderboardId",
        "user_id": "63ae4ac9-a0f4-4fba-xxxx-xxxxxxxx",
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxxxxxxx",
        "score": 1000,
        "subscore": 0,
        "metadata": "{\"key\":\"value\"}",
        "expiredAt": "2023-01-30T20:00:00-08:00",
        "updatedAt": "2023-01-26T19:45:58-08:00"
    },
]
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (-1 失敗) |
| message | String | エラーメッセージ |
| rank | Int | ランキング |
| project_id | String | プロジェクト ID |
| leaderboardId | String | ダッシュボードで作成したリーダーボード固有 ID |
| user_id | String | ユーザー ID |
| score | Int | スコア |
| subscore | Int | サブスコア |
| metadata | Int | ユーザー定義データ |
| updatedAt | String | アップデート日 |
| expiredAt | String | 満了日 |

失敗

```
{
    "status": -1,
    "message": "照会失敗"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (失敗時 Error code参照) |
| message | String | エラー内容 |

## 特定の検索キーワードを利用したスコア取得 API

#### Request

- Method : GET
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs

IDによる検索方法

```
GET
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "leaderboardId" : "leaderboardId",
     "search" : "user_id",
     "query" : "f1deb103-cae1-47dd-b0aa-xxxxxxxxxx",
    "offset": 0,
    "per_page": 20
}
```

SCORE範囲による検索方法

```
GET
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "leaderboardId" : "leaderboardId",
     "search" : "score",
     "query" : "99-120",
    "offset": 0,
    "per_page": 20
}
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | O | ダッシュボードで作成したリーダーボード固有 ID |
| offset | Integer | X | OFFSET |
| per_page | Integer | X | LIMIT |

#### Response

成功

```
[
    {
        "rank": 5,
        "leaderboard_id": "leaderboardId",
        "user_id": "f1deb103-cae1-47dd-b0aa-xxxxxx",
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxxxxx",
        "score": 99,
        "subscore": 100,
        "metadata": "{\"key\":\"value\"}",
        "expiredAt": "2023-01-30T20:00:00-08:00",
        "updatedAt": "2023-01-26T16:23:39-08:00"
    }
]
```

失敗

```
{
    "status": -1,
    "message": "エラーメッセージ"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (失敗時 Error code参照) |
| message | String | エラー内容 |

## リーダーボード情報およびユーザー数取得 API

#### Request

- Method : GET
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards?/{leaderboardId}?offset=0&per_page=10

```
GET
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboard
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | O | ダッシュボードで作成したリーダーボード固有 ID |
| offset | Integer | X | OFFSET |
| per_page | Integer | X | LIMIT |

#### Response

成功

```
[
    {
        "status": true,
        "ranking": "best",
        "tie_breaking": "first",
        "id": "TGVhZGVyYm9hcmQ6YXNkYWRhZHNhZHNh",
        "name": "test",
        "description": "TEST",
        "descending": true,
        "resetDay": 0,
        "resetTime": "00:00",
        "resetDate": 1,
        "startedAt": "2023-01-25T12:09:47-08:00",
        "timezone": "America/Kralendijk",
        "project_id": "ec8231b2-6b20-4ad1-9c59-8e183087a742",
        "period_type": "monthly",
        "icon_url": "sdadasds",
        "user_count": 28,
    }
]
```

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| id | String | O | リーダーボード固有 ID |
| projectId | String | O | プロジェクト ID |
| status | Boolean | O | 状態 |
| is_check_user | Boolean | X | ユーザー IDチェックの有無 |
| name | String | X | リーダーボード名 |
| description | String | X | 説明 |
| icon_url | String | X | アイコン URL |
| descending | Boolean | X | ソート |
| startedAt | String | X | 開始日 |
| expiredAt | String | X | 終了日(seasonの場合) |
| timezone | String | X | タイムゾーン |
| period_type | String | X | 周期(daily、weekly、monthly、season) |
| resetDay | Integer | X | 初期化曜日1: 日曜日、2. 月曜日、3. 火曜日、4. 水曜日、5. 木曜日、6. 金曜日、7. 土曜日(periodTypeが weeklyの場合) |
| resetTime | String | X | 初期化時間 |
| resetDate | Integer | X | 初期化日1~31(periodTypeが monthlyの場合) |
| ranking | String | O | ランキングアップデート基準(latest、accumulated、best) |
| tie_breaking | String | O | 同点者処理基準(first、last) |

失敗

```
{
    "status": -1,
    "message": "エラーメッセージ"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (失敗時 Error code参照) |
| message | String | エラー内容 |

## リーダーボードでユーザースコア照会 API

#### Request

- Method : GET
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboard/{leaderboardID}/user{userid}

```
GET
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboard
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardID | String | O | ダッシュボードで作成したリーダーボード固有 ID |
| userid | String | O | ユーザー ID |

#### Response

成功

```
{
	"rank": 1,
	"leaderboard_id": "leaderboardID",
	"user_id": "8f372bf4-XXXX-XXXX-XXXX-XXXXXXXX",
	"project_id": "ec8231b2-6b20-4ad1-XXXX-XXXXXXXX",
	"score": 1,
	"prev_score": null,
	"subscore": 10,
	"metadata": "",
	"user_count": 2,
	"expiredAt": "2023-01-30T17:00:00+09:00",
	"updatedAt": "2023-01-30T11:55:37+09:00"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (-1 失敗) |
| message | String | エラーメッセージ |
| rank | Int | ランキング |
| project_id | String | プロジェクト ID |
| leaderboardId | String | ダッシュボードで作成したリーダーボード固有 ID |
| user_id | String | ユーザー ID |
| score | Int | スコア |
| subscore | Int | サブスコア |
| metadata | Int | ユーザー定義データ |
| updatedAt | String | アップデート日 |
| expiredAt | String | 満了日 |

失敗

```
{
    "status": -1,
    "message": "エラーメッセージ"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (失敗時 Error code参照) |
| message | String | エラー内容 |

## リーダーボード登録ユーザー削除 API

#### Request

- Method : DELETE
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs

```
DELETE
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboardlogs
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
     "leaderboardId" : "leaderboardId",
     "userId" : "560963c3-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | X | リーダーボード ID |
| userId | String | X | リーダーボードユーザー ID |

#### Response

成功

```
[
    {
        "leaderboard_id": "leaderboardId",
        "user_id": "f1deb103-cae1-47dd-b0aa-xxxxxx",
        "project_id": "ec8231b2-6b20-4ad1-9c59-xxxxxxxxx",
        "score": 99,
        "subscore": 100,
        "metadata": "{\"key\":\"value\"}",
        "expiredAt": "2023-01-30T20:00:00-08:00",
        "updatedAt": "2023-01-26T16:23:39-08:00"
    }
]
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (-1 失敗) |
| message | String | エラーメッセージ |
| project_id | String | プロジェクト ID |
| leaderboardId | String | ダッシュボードで作成したリーダーボード固有 ID |
| user_id | String | ユーザー ID |
| score | Int | スコア |
| subscore | Int | サブスコア |
| metadata | Int | ユーザー定義データ |
| updatedAt | String | アップデート日 |
| expiredAt | String | 満了日 |

失敗

```
{
    "status": -1,
    "message": "エラーメッセージ"
}
```

| Attribute | Type | Description |
| --- | --- | --- |
| status | Int | 結果値 (失敗時 Error code参照) |
| message | String | エラー内容 |

## リーダーボード登録 API

#### Request

- Method : POST
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards

```
POST
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
    "id" : "leaderboardId",
    "status": true,
    "name": "name",
    "description": "description",
    "iconUrl" : "icon_url",
    "descending": true,
    "startedAt" : "2023-01-22 13:00:00",
    "timezone" : "Asia/Seoul",
    "periodType" : "weekly",
    "resetDay": 1,
    "resetDate": 1,
    "resetTime" : "00:01:01",
    "ranking" : "latest", 
    "tie_breaking" : "first"
}
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| id | String | O | リーダーボード固有 ID |
| projectId | String | O | プロジェクト ID |
| status | Boolean | O | 状態 |
| is_check_user | Boolean | X | ユーザー IDチェックの有無 |
| name | String | X | リーダーボード名 |
| description | String | X | 説明 |
| iconUrl | String | X | アイコン URL |
| descending | Boolean | X | ソート |
| startedAt | String | X | 開始日 |
| expiredAt | String | X | 終了日(seasonの場合) |
| timezone | String | X | タイムゾーン |
| period_type | String | X | 周期(daily、weekly、monthly、season) |
| resetDay | Integer | X | 初期化曜日1: 日曜日、2. 月曜日、3. 火曜日、4. 水曜日、5. 木曜日、6. 金曜日、7. 土曜日(periodTypeが weeklyの場合) |
| resetTime | String | X | 初期化時間 |
| resetDate | Integer | X | 初期化日1~31(periodTypeが monthlyの場合) |
| ranking | String | O | ランキングアップデート基準(latest、accumulated、best) |
| tie_breaking | String | O | 同点者処理基準(first、last) |

#### Response

成功

```
{
   "leaderboard": {
        "status": true,
        "is_check_user": true,
        "ranking": "latest",
        "tie_breaking": "first",
        "id": "TGVhZGVyYm9hcmQ6ZHNzZGFkMTIyMjIyMTJhZA==",
        "name": "name",
        "description": "description",
        "descending": true,
        "resetDay": 1,
        "resetTime": "00:01:01",
        "resetDate": 1,
        "startedAt": "2023-01-22T13:00:00-08:00",
        "expiredAt": "2023-11-22T13:00:00-08:00",
        "timezone": "Asia/Seoul",
        "project_id": "ec8231b2-6b20-4ad1-9c59-8e183087a742",
        "period_type": "weekly",
        "icon_url": "icon_url",
        "user_count": null,
        "updatedAt": "2023-02-01T15:52:24-08:00",
        "createdAt": "2023-02-01T15:52:24-08:00"
    }
}
```

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| id | String | O | リーダーボード固有 ID |
| projectId | String | O | プロジェクト ID |
| status | Boolean | O | 状態 |
| is_check_user | Boolean | X | ユーザー IDチェックの有無 |
| name | String | X | リーダーボード名 |
| description | String | X | 説明 |
| icon_url | String | X | アイコン URL |
| descending | Boolean | X | ソート |
| startedAt | String | X | 開始日 |
| expiredAt | String | X | 終了日(seasonの場合) |
| timezone | String | X | タイムゾーン |
| period_type | String | X | 周期(daily、weekly、monthly、season) |
| resetDay | Integer | X | 初期化曜日1: 日曜日、2. 月曜日、3. 火曜日、4. 水曜日、5. 木曜日、6. 金曜日、7. 土曜日(periodTypeが weeklyの場合) |
| resetTime | String | X | 初期化時間 |
| resetDate | Integer | X | 初期化日1~31(periodTypeが monthlyの場合) |
| ranking | String | O | ランキングアップデート基準(latest、accumulated、best) |
| tie_breaking | String | O | 同点者処理基準(first、last) |

失敗

```
 "status": -1,
"message": "エラーメッセージ"
```

| Attribute | Type | Description |
| --- | --- | --- |
| code | Int | 結果値 (1: 成功、失敗時 Error code参照) |
| error | String | エラー内容 |

## リーダーボード変更 API

#### Request

- Method : PUT
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards/{leaderboardId}

```
PUT
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards/{leaderboardId}
Header : 'content-type: application/json'
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
data:
{
    "status": true,
    "name": "name",
    "description": "description",
    "iconUrl" : "icon_url",
    "descending": true,
    "startedAt" : "2023-01-22 13:00:00",
    "timezone" : "Asia/Seoul",
    "periodType" : "weekly",
    "resetDay": 1,
    "resetDate": 1,
    "resetTime" : "00:01:01",
    "ranking" : "latest", 
    "tie_breaking" : "first"
}
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | O | リーダーボード固有 ID |
| status | Boolean | O | 状態 |
| is_check_user | Boolean | X | ユーザー IDチェックの有無 |
| name | String | X | リーダーボード名 |
| description | String | X | 説明 |
| icon_url | String | X | アイコン URL |
| descending | Boolean | X | ソート |
| startedAt | String | X | 開始日 |
| expiredAt | String | X | 終了日(seasonの場合) |
| timezone | String | X | タイムゾーン |
| period_type | String | X | 周期(daily、weekly、monthly、season) |
| resetDay | Integer | X | 初期化曜日1: 日曜日、2. 月曜日、3. 火曜日、4. 水曜日、5. 木曜日、6. 金曜日、7. 土曜日(periodTypeが weeklyの場合) |
| resetTime | String | X | 初期化時間 |
| resetDate | Integer | X | 初期化日1~31(periodTypeが monthlyの場合) |
| ranking | String | O | ランキングアップデート基準(latest、accumulated、best) |
| tie_breaking | String | O | 同点者処理基準(first、last) |

#### Response

成功

```
{
   "leaderboard": {
        "status": true,
        "is_check_user": true,
        "ranking": "latest",
        "tie_breaking": "first",
        "id": "TGVhZGVyYm9hcmQ6ZHNzZGFkMTIyMjIyMTJhZA==",
        "name": "name",
        "description": "description",
        "descending": true,
        "resetDay": 1,
        "resetTime": "00:01:01",
        "resetDate": 1,
        "startedAt": "2023-01-22T13:00:00-08:00",
        "expiredAt": "2023-11-22T13:00:00-08:00",
        "timezone": "Asia/Seoul",
        "project_id": "ec8231b2-6b20-4ad1-9c59-8e183087a742",
        "period_type": "weekly",
        "icon_url": "icon_url",
        "user_count": null,
        "updatedAt": "2023-02-01T15:52:24-08:00",
        "createdAt": "2023-02-01T15:52:24-08:00"
    }
}
```

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| id | String | O | リーダーボード固有 ID |
| projectId | String | O | プロジェクト ID |
| status | Boolean | O | 状態 |
| is_check_user | Boolean | X | ユーザー IDチェックの有無 |
| name | String | X | リーダーボード名 |
| description | String | X | 説明 |
| icon_url | String | X | アイコン URL |
| descending | Boolean | X | ソート |
| startedAt | String | X | 開始日 |
| expiredAt | String | X | 終了日(seasonの場合) |
| timezone | String | X | タイムゾーン |
| period_type | String | X | 周期(daily、weekly、monthly、season) |
| resetDay | Integer | X | 初期化曜日1: 日曜日、2. 月曜日、3. 火曜日、4. 水曜日、5. 木曜日、6. 金曜日、7. 土曜日(periodTypeが weeklyの場合) |
| resetTime | String | X | 初期化時間 |
| resetDate | Integer | X | 初期化日1~31(periodTypeが monthlyの場合) |
| ranking | String | O | ランキングアップデート基準(latest、accumulated、best) |
| tie_breaking | String | O | 同点者処理基準(first、last) |

失敗

```
 "status": -1,
"message": "エラーメッセージ"
```

| Attribute | Type | Description |
| --- | --- | --- |
| code | Int | 結果値 (1: 成功、失敗時 Error code参照) |
| error | String | エラー内容 |

## リーダーボード削除 API

#### Request

- Method : DELETE
- URI : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards/{leaderboardId}

```
DELETE
url : https://gamepot.apigw.ntruss.com/gpapps/v2/leaderboards/leaderboardId
Header 'x-api-key: 86dcgffae0xxxxxxxxxxxxxx'
Header : 'x-project-id: ec8231b2-6b20-4ad1-xxxx-xxxxxxxxx'
```

| Header | Type | Required | Description |
| --- | --- | --- | --- |
| X-API-KEY | String | O | GAMEPOTで発行する認証キー |
| X-PROJECT-ID | String | O | ダッシュボードプロジェクト ID |

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| leaderboardId | String | O | リーダーボード固有 ID |

#### Response

成功

```
{
   "leaderboard": {
        "status": true,
        "is_check_user": true,
        "ranking": "latest",
        "tie_breaking": "first",
        "id": "TGVhZGVyYm9hcmQ6ZHNzZGFkMTIyMjIyMTJhZA==",
        "name": "name",
        "description": "description",
        "descending": true,
        "resetDay": 1,
        "resetTime": "00:01:01",
        "resetDate": 1,
        "startedAt": "2023-01-22T13:00:00-08:00",
        "expiredAt": "2023-11-22T13:00:00-08:00",
        "timezone": "Asia/Seoul",
        "project_id": "ec8231b2-6b20-4ad1-9c59-8e183087a742",
        "period_type": "weekly",
        "icon_url": "icon_url",
        "user_count": null,
        "updatedAt": "2023-02-01T15:52:24-08:00",
        "createdAt": "2023-02-01T15:52:24-08:00"
    }
}
```

成功

| Attribute | Type | Required | Description |
| --- | --- | --- | --- |
| id | String | O | リーダーボード固有 ID |
| projectId | String | O | プロジェクト ID |
| status | Boolean | O | 状態 |
| is_check_user | Boolean | X | ユーザー IDチェックの有無 |
| name | String | X | リーダーボード名 |
| description | String | X | 説明 |
| icon_url | String | X | アイコン URL |
| descending | Boolean | X | ソート |
| startedAt | String | X | 開始日 |
| expiredAt | String | X | 終了日(seasonの場合) |
| timezone | String | X | タイムゾーン |
| period_type | String | X | 周期(daily、weekly、monthly、season) |
| resetDay | Integer | X | 初期化曜日1: 日曜日、2. 月曜日、3. 火曜日、4. 水曜日、5. 木曜日、6. 金曜日、7. 土曜日(periodTypeが weeklyの場合) |
| resetTime | String | X | 初期化時間 |
| resetDate | Integer | X | 初期化日1~31(periodTypeが monthlyの場合) |
| ranking | String | O | ランキングアップデート基準(latest、accumulated、best) |
| tie_breaking | String | O | 同点者処理基準(first、last) |

失敗

```
 "status": -1,
"message": "エラーメッセージ"
```

| Attribute | Type | Description |
| --- | --- | --- |
| code | Int | 結果値 (1: 成功、失敗時 Error code参照) |
| error | String | エラー内容 |