Character inquiry

Prev Next

We are preparing a localization service for the content. We will do our best to provide the localization service as soon as possible.

Retrieves the in-game player ID.

request

GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/player/{playerID}
Item type Required Explanation 비고
projectId String O ProjectId in GamePot SDK
playerID String O Player ID of GamePot SDK

Request header

Header name Required Explanation
x-api-key O Authentication key issued by GamePot
accept-language X Language used

answer

Field name type Explanation
status Int Result value (1: success)
id String User ID
player_id String Player ID
server_id String Server ID
name String Player name
level String Player level
userdata String Registered Userdata
ip String Player ip
createdAt String Player creation date
updatedAt String Player update date
user_id String Gamepot UID

example

Request example


curl --request GET \
  --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/player/dodo  \
  --header 'accept-language: ko' \
  --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'

Example response

{
  "status": 1,
  "result": {
    "id": "xxxxxxxxxxxxxxx",
    "player_id": "Test ID",
    "server_id": "Test server",
    "name": "Test name",
    "level": "12",
    "userdata": "dododo",
    "ip": "xxx.xxx.xxx.xxx",
    "createdAt": "Fri Feb 21 2020 14:15:33 GMT+0900 (GMT+09:00)",
    "updatedAt": "Fri Feb 21 2020 14:15:33 GMT+0900 (GMT+09:00)",
    "user_id": "xxxxxxxxxxxxxxx"
  }
}

Error code

Common error code that occurs when requesting Gamepot Open API.

parameter Explanation
status Error code (1: Refer to Error code in case of success or failure )
message Error details
Error code Explanation
-1 If you used a key that is not on the dashboard
-2 The key of the dashboard and the key of the header are different.
-3 When using a key deleted from the dashboard
-4 The dashboard used unused keys.
-5 If the key has expired
-6 If there is no project ID
{
  "status": -6,
  "message": "projectId was wrong."
}