GET /player/{player_identifier}

엔드포인트: GET /v1/pdapi/player/<player_identifier>

인증: Bearer 토큰

필요 권한: REST.Player.Read

용도

플레이어 한 명의 정보를 반환합니다. UserId, PlayerUID 등 지원되는 플레이어 식별자를 사용할 수 있습니다.

없습니다.

요청 본문은 없습니다.

필드	자료형	설명
`Player`	객체	플레이어 상세 정보입니다.

Player 객체 스키마:

필드	자료형	설명
`Name`	문자열	현재 또는 저장된 플레이어 이름입니다.
`IP`	문자열	플레이어 IP 주소입니다. 확인할 수 없으면 빈 문자열입니다.
`PlayerUID`	문자열	Palworld 저장 데이터에서 사용하는 플레이어 UID입니다.
`UserId`	문자열	플랫폼 사용자 ID입니다. 확인할 수 없으면 빈 문자열입니다.
`GuildName`	문자열	길드 이름입니다. 확인할 수 없으면 빈 문자열입니다.
`GuildUUID`	문자열	길드 UUID입니다. 확인할 수 없으면 0으로 채운 GUID입니다.
`Status`	문자열	저장된 플레이어 계정 상태입니다.
`WorldLocation`	객체	현재 또는 마지막으로 저장된 월드 좌표입니다.
`MapLocation`	객체	변환된 맵 좌표입니다.

위치 객체 스키마:

오류 응답 본문은 다음 형식을 사용합니다:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "사람이 읽을 수 있는 오류 메시지",
        "Details": {}
    }
}

HTTP	오류 코드	발생 조건
`401`	`INVALID_TOKEN`	`Authorization` 헤더가 없거나 형식이 잘못되었거나, 설정된 Bearer 토큰과 일치하지 않습니다.
`403`	`MISSING_PERMISSION`	토큰은 유효하지만 이 엔드포인트에 필요한 권한이 없습니다.
`400`	`INVALID_JSON`	요청 본문이 있지만 JSON으로 해석할 수 없습니다.
`400`	`REQUEST_FAILED`	게임 스레드 콜백에서 예외가 발생했거나 공통 플레이어/리소스 확인 처리에 실패했습니다.
`500`	`REQUEST_TIMEOUT`	내부 게임 스레드 콜백이 5초 안에 완료되지 않았습니다.
`404`	`PLAYER_NOT_FOUND`	지정한 `player_identifier`와 일치하는 접속 중인 플레이어가 없습니다.
`404`	`PLAYER_ACCOUNT_NOT_FOUND`	플레이어를 찾았지만 계정 데이터를 불러올 수 없습니다.

GET /v1/pdapi/player/steam_76561198012345678

GET /v1/pdapi/player/b7f4e91a-2c53-4d8f-a6e1-93c4bb62a7d1