查询角色

查询游戏内玩家ID。

请求

---

GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/player/{playerID}

项目	类型	是否为必填项	描述	备注
projectId	String	O	GamePot SDK的projectId
playerID	String	O	GamePot SDK的玩家ID

请求头

报头名称	是否为必填项	描述
x-api-key	O	GamePot发放的认证密钥
accept-language	X	使用语言

响应

---

字段名称	类型	描述
status	Int	结果值\（1：成功\）
id	String	用户ID
player_id	String	玩家ID
server_id	String	服务器ID
name	String	玩家名
level	String	玩家等级
userdata	String	注册的Userdata
ip	String	玩家IP
createdAt	String	玩家创建日期
updatedAt	String	玩家更新日期
user_id	String	GAMEPOT UID

示例

---

请求示例

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'

响应示例

{
  "status":1,
  "result":{
    "id":"xxxxxxxxxxxxxxx",
    "player_id":"测试ID",
    "server_id":"测试服务器",
    "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"
  }
}

错误代码

---

发送Gamepot Open API请求时发生的通用错误代码。

参数	描述
status	错误代码\（1：成功，失败时请参考Error code\）
message	错误详细描述

错误代码	描述
-1	使用了仪表盘上没有的密钥时
-2	仪表盘密钥和报头的密钥不同时
-3	使用了仪表盘已删除的密钥时
-4	使用了仪表盘中作为未使用处理的密钥时
-5	密钥到期时
-6	没有项目ID时

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