콘텐츠로 이동

POST /forgettech/{player_identifier}

엔드포인트: POST /v1/pdapi/forgettech/<player_identifier>

인증: Bearer 토큰

필요 권한: REST.Techs.Forget

용도

플레이어가 배운 기술 하나, 여러 개 또는 전체를 제거합니다.

경로 매개변수

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

쿼리 매개변수

없습니다.

요청 본문

Technology에는 단일 TechID, 문자열 "All" 또는 TechID 문자열 배열을 지정할 수 있습니다. 배열 안에는 "All"을 넣지 마세요.

응답 스키마

200 응답 스키마

필드 자료형 설명
ForgottenCount 정수 플레이어에게서 제거한 기술 수입니다.
Forgotten string[] or string 제거한 기술 ID입니다. 해금된 기술을 모두 제거했다면 All입니다.
Skipped 문자열 배열 해금되지 않아 건너뛴 기술 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초 안에 완료되지 않았습니다.
400 INVALID_REQUEST Technology가 없거나 요구되는 형식의 문자열/배열이 아닙니다.
400 VALIDATION_FAILED Technology 배열에 문자열이 아닌 값, All 또는 잘못된 기술 식별자가 있습니다.

예제

GDK 플레이어의 기술 하나 제거

POST /v1/pdapi/forgettech/gdk_2533274812345678
{
    "Technology": "Technology_ElecBaton"
}

PlayerUID로 여러 기술 제거

POST /v1/pdapi/forgettech/b7f4e91a-2c53-4d8f-a6e1-93c4bb62a7d1
{
    "Technology": [
        "Technology_ElecBaton",
        "Technology_GrapplingGun"
    ]
}

Steam 플레이어의 모든 기술 제거

POST /v1/pdapi/forgettech/steam_76561198012345678
{
    "Technology": "All"
}

활용 사례

  • 실수로 부여한 기술을 제거합니다.
  • "All"로 테스트 계정의 기술을 초기화합니다.
  • 요청 전후에 GET /techs로 현재 상태를 확인하세요.