아이디 중복체크 API (/users/check-username)

메서드 요청 URL
GET /api/users/check-username?username={username}

Request Header

파라미터 타입 필수여부 설명
Content-Type String 필수 application/json

Role Requirement

Request Elements

파라미터 타입 필수여부 설명
username String 필수 중복 확인할 사용자 ID

요청 예시

GET /api/users/check-username?username=user123

Response Elements

필드 타입 필수여부 설명
message String 필수 응답 메시지 (사용 가능한 아이디입니다, 이미 사용 중인 아이디입니다.)
code Integer 필수 HTTP 상태 코드
data Object 필수
username String 필수 입력한 사용자 ID
is-available Boolean 필수 사용 가능 여부 (true = 사용 가능, false = 이미 사용 중)

응답 예시

{
    "message": "사용 가능한 아이디입니다.",
    "code": 200,
    "data": {
        "username": "user123",
        "is-available": true
    }
}

{
    "message": "이미 사용 중인 아이디입니다.",
    "code": 400,
    "data": {
        "username": "user123",
        "is-available": false
    }
}

{
    "message": "아이디를 입력하세요.",
    "code": 400,
    "data": null
}