캐릭터 조회
- 인쇄
- PDF
캐릭터 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
게임 내 플레이어 아이디를 조회합니다.
요청
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."
}
이 문서가 도움이 되었습니까?