캐릭터 조회

Prev Next

게임 내 플레이어 아이디를 조회합니다.

요청

GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/player/{playerID}
항목 타입 필수 여부 설명 비고
projectId String O GamePot SDK의 projectId
playerID String O GamePot SDK의 플레이어 아이디

요청 헤더

헤더명 필수 여부 설명
x-api-key O GamePot에서 발급하는 인증 키
accept-language X 사용 언어

응답

필드명 타입 설명
status Int 결과값 (1: 성공)
id String 사용자 ID / / 게임팟 내부 고유값 무시해주세요.
player_id String 플레이어 아이디
server_id String 서버 아이디
name String 플레이어 명
level String 플레이어 레벨
userdata String 등록한 Userdata
ip String 플레이어 아이피
createdAt String 플레이어 생성일
updatedAt String 플레이어 갱신일
user_id String 게임팟 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": "테스트아이디",
    "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 프로젝트 아이디가 없는 경우 
{
  "status": -6,
  "message": "projectId was wrong."
}