👤Users

로그인, 회원가입, 사용자 권한 부여

회원가입

POST /users/signup

사용자 회원가입 요청

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
username	string	사용자 닉네임
password	string	사용자 비밀번호

Response

201

{
  "userId": 1,
  "username": "John",
  "role": "USER",
  "points": 5000,
  "message": "회원가입에 성공했습니다."
}

400

{
  "username": "username 은 4자 이상 10자 이하여야 합니다.",
  "password": "password 는 8자 이상 15자 이하여야 합니다."
}

400

{
  "uesrname": "username 은 알파벳 소문자와 숫자를 포함해야 합니다.",
  "password": "password 는 알파벳 대소문자, 숫자, 특수문자를 모두 포함해야 합니다."
}

409

{
  "username": "중복된 username 입니다."
}

로그인

POST /users/login

사용자 로그인 요청

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
username	string	사용자 닉네임
password	string	사용자 비밀번호

Response

202

Headers

Name	Value
Authorization	Bearer <token>

Body

{
  "accessToken": "sample.token.value",
  "message": "로그인에 성공했습니다."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

사용자 목록 조회

GET /users

ADMIN 사용자의 사용자 목록 조회

Headers

Name	Value
Authorization	Bearer <token>

Response

200

{
  "totalCounts": 2,
  "users": [
    {
      "userId": "1",
      "username": "john_doe",
      "role": "ADMIN",
      "points": 5000
    },
    {
      "userId": "2",
      "username": "jane_smith",
      "role": "USER",
      "points": 3000
    }
  ]
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

403

{
  "message": "Access Denied"
}

사용자 권한 부여

POST /users/{userId}/role

특정 사용자에게 ADMIN 또는 USER 역할 부여 ADMIN 사용자만 사용 가능 ADMIN 사용자는 모든 게시글 및 댓글 수정/삭제 가능

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Description
userId	권한을 부여할 사용자의 ID

Body

Name	Type	Description
role	string	권한 이름 (ADMIN USER)

Response

200

{
  "userId": 1,
  "role": "ADMIN"
}

400

{
  "role": "role 은 'ADMIN' 또는 'USER' 여야 합니다."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

403

{
  "message": "Access Denied"
}

404

{
  "message": "$userId 번 사용자를 찾을 수 없습니다."
}

사용자 포인트 충전

POST /users/{userId}/points

특정 사용자의 포인트 충전 ADMIN 사용자만 사용 가능

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Description
userId	포인트를 충전할 사용자의 ID

Body

Name	Type	Description
points	number	포인트 충전량

Response

200

{
  "userId": 1,
  "username": "John",
  "chargedPoints": 1000,
  "totalPoints": 6000
}

400

{
  "message": "포인트 잔액은 0 미만이 될 수 없습니다."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

403

{
  "message": "Access Denied"
}

404

{
  "message": "$userId 번 사용자를 찾을 수 없습니다."
}