GET /players

엔드포인트: GET /v1/pdapi/players

인증: Bearer 토큰

필요 권한: REST.Players.Read

용도

서버가 알고 있는 플레이어의 식별 정보와 상태를 나열합니다. 관리자 도구의 플레이어 선택 기능에 사용하세요.

없습니다.

없습니다.

요청 본문은 없습니다.

필드	자료형	설명
`Meta`	객체	플레이어 목록의 인원수 정보입니다.
`Players`	객체 배열	식별 정보, 길드, 상태, 위치 정보가 포함된 등록 플레이어 목록입니다.

Meta 객체 스키마:

필드	자료형	설명
`PlayerCount`	정수	반환한 플레이어 계정 수입니다.
`OnlineCount`	정수	반환한 플레이어 중 현재 접속 중인 수입니다.

Players[] 항목 스키마:

필드	자료형	설명
`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초 안에 완료되지 않았습니다.
`500`	`PLAYER_MANAGER_UNAVAILABLE`	서버에서 Palworld 플레이어 관리자에 접근할 수 없습니다.

GET /v1/pdapi/players

GET /v1/pdapi/players