GET /progression/{player_identifier}

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

인증: Bearer 토큰

필요 권한: REST.Progression.Read

용도

경험치, 레벨 관련 상태, 유물 총량, 기술 포인트 총량 등 플레이어의 성장 정보를 조회합니다.

경로 매개변수

• player_identifier: 대상 플레이어의 UserId 또는 PlayerUID입니다.

쿼리 매개변수

없습니다.

요청 본문

요청 본문은 없습니다.

응답 스키마

200 응답 스키마

필드	자료형	설명
Meta	객체	대상 플레이어 메타데이터입니다.
Progression	객체	성장, 재화, 처치, 포획 및 활동 데이터입니다.

Meta 객체 스키마:

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

Progression 객체 스키마:

필드	자료형	설명
Player	객체	플레이어 레벨, 경험치, 미사용 능력치 포인트입니다.
Currencies	객체	유물 및 기술 포인트 총량입니다.
Bosses	객체	보스 처치 횟수 및 플래그입니다.
Captures	객체	팰 포획 및 도축 횟수입니다.
Activities	객체	제작, 던전, 낚시, 보물 및 기타 활동 횟수입니다.

Progression.Player 객체 스키마:

필드	자료형	설명
level	정수	현재 플레이어 레벨입니다.
exp	정수	현재 경험치입니다.
unusedStatusPoints	정수	플레이어의 미사용 능력치 포인트입니다.

Progression.Currencies 객체 스키마:

필드	자료형	설명
relics	객체	유물 유형을 키로 하는 유물 포인트 총량입니다.
technologyPoints	정수	기술 포인트 총량입니다.
ancientTechnologyPoints	정수	고대 기술 포인트 총량입니다.

Progression.Bosses 객체 스키마:

필드	자료형	설명
towerBossDefeatCounts	객체	보스 ID를 키로 하는 탑 보스 처치 횟수입니다.
normalBossDefeatFlags	객체	보스 ID를 키로 하는 일반 보스 처치 플래그입니다.
raidBossDefeatCounts	객체	보스 ID를 키로 하는 레이드 보스 처치 횟수입니다.
totalBossDefeatCount	정수	탑 보스 처치 횟수 합계입니다.
predatorDefeatCount	정수	포식자 처치 횟수입니다.

Progression.Captures 객체 스키마:

필드	자료형	설명
tribeCaptureCount	정수	전체 종족 포획 횟수입니다.
palCaptureCounts	객체	팰 ID를 키로 하는 팰 포획 횟수입니다.
palCaptureBonusCounts	객체	팰 ID를 키로 하는 팰 포획 보너스 횟수입니다.
palButcherCounts	객체	팰 ID를 키로 하는 팰 도축 횟수입니다.

Progression.Activities 객체 스키마:

필드	자료형	설명
craftItemCounts	객체	아이템 ID를 키로 하는 제작 수량입니다.
normalDungeonClearCount	정수	일반 던전 완료 횟수입니다.
fixedDungeonClearCount	정수	고정 던전 완료 횟수입니다.
oilrigClearCount	정수	오일 리그 완료 횟수입니다.
palRankUpCounts	객체	팰 ID를 키로 하는 등급 상승 횟수입니다.
arenaSoloClearCounts	객체	아레나 ID를 키로 하는 솔로 아레나 완료 횟수입니다.
npcTalkCounts	객체	NPC ID를 키로 하는 대화 횟수입니다.
fishingCounts	객체	물고기 ID를 키로 하는 낚시 횟수입니다.
foundTreasureCount	정수	발견한 보물 수입니다.
campConqueredCount	정수	점령한 야영지 수입니다.
firstFishingComplete	불리언	첫 낚시 완료가 기록되어 있는지 나타냅니다.

오류 응답

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

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

예제

PS5 UserID로 성장 정보 조회

GET /v1/pdapi/progression/ps5_c481a77e22004b9d

PlayerUID로 성장 정보 조회

GET /v1/pdapi/progression/92b8f6ac-1a3d-4a9e-8f52-cc741db8c20a

활용 사례

• 성장 보상을 지급하기 전에 현재 값을 확인합니다.
• POST /give/progression으로 지원 작업을 수행한 뒤 결과를 확인합니다.
• 신뢰할 수 있는 관리자 대시보드에 플레이어 요약 패널을 만듭니다.