GET /items/{player_identifier}

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

인증: Bearer 토큰

필요 권한: REST.Items.Read

용도

대상 플레이어의 아이템 목록을 조회합니다. 응답에 있는 아이템 식별자는 paldeck.cc/items에서 검색할 수 있습니다.

없습니다.

요청 본문은 없습니다.

필드	자료형	설명
`Meta`	객체	대상 플레이어 메타데이터입니다.
`Inventory`	객체	대상 플레이어의 인벤토리 컨테이너입니다.

Meta 객체 스키마:

필드	자료형	설명
`PlayerUID`	문자열	Palworld 저장 데이터에서 사용하는 플레이어 UID입니다.
`Player`	문자열	요청 경로에 지정한 플레이어 식별자입니다.

Inventory 객체 스키마:

인벤토리 컨테이너 객체 스키마:

필드	자료형	설명
`Available`	불리언	컨테이너에 접근할 수 있었는지 나타냅니다.
`ContainerID`	문자열	Palworld 컨테이너 ID입니다. 사용할 수 없으면 빈 문자열입니다.
`UsedSlots`	정수	사용 중인 슬롯 수입니다.
`MaxSlots`	정수	전체 슬롯 수입니다.
`FreeSlots`	정수	빈 슬롯 수입니다.
`Slots`	객체	슬롯 인덱스를 키로 하는 사용 중인 슬롯 목록입니다.

Slots 항목 스키마:

필드	자료형	설명
`ItemID`	문자열	Palworld 아이템 식별자입니다.
`Count`	정수	슬롯의 스택 수량입니다.

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

{
    "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초 안에 완료되지 않았습니다.

GET /v1/pdapi/items/steam_76561198087654321

GET /v1/pdapi/items/gdk_2533274812345678