콘텐츠로 이동

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입니다.

오류 응답

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

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

예제

UserID로 해금한 기술 조회

GET /v1/pdapi/techs/gdk_2533274812345678

PlayerUID로 해금한 기술 조회

GET /v1/pdapi/techs/f0a1c3e9-7d5b-4a28-8c33-411fdc2e6b74

활용 사례

  • 기술을 습득시키거나 제거하기 전에 플레이어가 해당 TechID를 이미 가지고 있는지 확인합니다.
  • 해금한 기술과 습득 가능한 기술을 구분하는 관리자 페이지를 만듭니다.
  • 지원 작업 후 성장 정보를 확인합니다.