콘텐츠로 이동

POST /unban/{user_id}

엔드포인트: POST /v1/pdapi/unban/<user_id>

인증: Bearer 토큰

필요 권한: REST.Punishments.Unban

용도

Banlist.json에서 사용자 ID의 차단을 해제합니다.

경로 매개변수

  • user_id: 차단을 해제할 사용자 ID입니다.

쿼리 매개변수

없습니다.

요청 본문

선택 JSON 필드로 문자열 Reason을 지정할 수 있습니다.

응답 스키마

200 응답 스키마

필드 자료형 설명
Success 불리언 활성 사용자 차단을 해제했으면 true입니다.
UserId 문자열 차단을 해제한 사용자 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 VALIDATION_FAILED 선택 요청 필드의 JSON 자료형이 잘못되었습니다.
404 BAN_NOT_FOUND 지정한 user_id에 활성 차단이 없습니다.

예제

Steam 사용자 차단 해제

POST /v1/pdapi/unban/steam_76561198012345678
{
    "Reason": "이의 신청 승인"
}

기본 사유로 PS5 사용자 차단 해제

POST /v1/pdapi/unban/ps5_c481a77e22004b9d
{}

활용 사례

  • 이의 신청 승인 후 사용자 차단을 해제합니다.
  • 추후 검토를 위해 사유를 기록하세요.
  • GET /banlist의 userId 또는 q로 결과를 확인하세요.