GET /techs/{player_identifier}
엔드포인트: GET /v1/pdapi/techs/<player_identifier>
인증: Bearer 토큰
필요 권한: REST.Techs.Read
용도
플레이어의 기술 정보를 조회합니다. 기술 식별자는 paldeck.cc/technology에서 검색할 수 있습니다.
경로 매개변수
player_identifier: 대상 플레이어의UserId또는PlayerUID입니다.
쿼리 매개변수
없습니다.
요청 본문
요청 본문은 없습니다.
응답 스키마
200 응답 스키마
| 필드 | 자료형 | 설명 |
|---|---|---|
Meta |
객체 | 대상 플레이어의 기술 수 메타데이터입니다. |
Techs |
객체 | 대상 플레이어의 기술 데이터입니다. |
Meta 객체 스키마:
| 필드 | 자료형 | 설명 |
|---|---|---|
PlayerUID |
문자열 | Palworld 저장 데이터에서 사용하는 플레이어 UID입니다. |
Player |
문자열 | 요청 경로에 지정한 플레이어 식별자입니다. |
UnlockedCount |
정수 | 현재 해금된 기술 수입니다. |
LockedCount |
정수 | 현재 잠긴 기술 수입니다. |
TotalCount |
정수 | 플레이어 데이터에 등록된 제작 기술의 총수입니다. |
Techs 객체 스키마:
| 필드 | 자료형 | 설명 |
|---|---|---|
Unlocked |
문자열 배열 | 플레이어가 현재 배운 기술 ID입니다. |
오류 응답
오류 응답 본문은 다음 형식을 사용합니다:
| HTTP | 오류 코드 | 발생 조건 |
|---|---|---|
401 |
INVALID_TOKEN |
Authorization 헤더가 없거나 형식이 잘못되었거나, 설정된 Bearer 토큰과 일치하지 않습니다. |
403 |
MISSING_PERMISSION |
토큰은 유효하지만 이 엔드포인트에 필요한 권한이 없습니다. |
400 |
INVALID_JSON |
요청 본문이 있지만 JSON으로 해석할 수 없습니다. |
400 |
REQUEST_FAILED |
대상 플레이어, 플레이어 계정, 기술 데이터 또는 기술 테이블을 확인할 수 없습니다. |
500 |
REQUEST_TIMEOUT |
내부 게임 스레드 콜백이 5초 안에 완료되지 않았습니다. |
예제
UserID로 해금한 기술 조회
PlayerUID로 해금한 기술 조회
활용 사례
- 기술을 습득시키거나 제거하기 전에 플레이어가 해당
TechID를 이미 가지고 있는지 확인합니다. - 해금한 기술과 습득 가능한 기술을 구분하는 관리자 페이지를 만듭니다.
- 지원 작업 후 성장 정보를 확인합니다.