User

유저 도메인 API 명세

회원 가입

회원가입

POST http://localhost:8080/users/regist

사용자가 서비스에 가입을 할 수 있도록 합니다.

Request Body

Name	Type	Description
userName*	string	유저의 이름
userId*	string	유저의 아이디
password*	string	유저의 비밀번호
role*	String	유저의 권한

200 회원가입 성공

{
    "success": true,
    "response": null,
    "error": null
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

400: Bad Request 이름, 아이디, 비밀번호 중에서 비어있을 경우

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

로그인

로그인

POST http://localhost:8080/users/login

사용자가 서비스에 로그인할 수 있도록 합니다.

헤더로 JWT를 응답합니다.

Request Body

Name	Type	Description
userId*	String	유저의 아이디
password*	String	유저의 비밀번호

200: OK 로그인 성공

{
    "success": true,
    "response": null,
    "error": null
}

400: Bad Request 아이디나 비밀번호가 비어있을 경우

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

회원 정보 조회

회원 정보 조회

GET http://localhost:8080/users

로그인 되어있는 유저의 정보를 조회합니다.

Headers

Name	Type	Description
token*	String	로그인 시 발급받은 JWT

200: OK 유저 정보 조회 성공

{
    "success": true,
    "response": {
        "idx": 1,
        "userId", "rhalstjr1999",
        "userName": "MinseokGo",
        "role": "USER",
        "orderCount": 17,
        "posts": [
            {
                "idx": 1,
                "title": "청학 B동 같이 시켜드실분",
                "createAt": "2023-07-29"
            },
            {
                "idx": 342,
                "title": "가입인사 드립니다.",
                "createAt": "2023-08-03"
            }
        ]        
    },
    "error": null
}

401: Unauthorized 인증되지 않았을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "인증되지 않았습니다.",
        "status": 401
    }
}

404: Not Found 해당 유저의 정보를 찾을 수 없을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 유저를 찾을 수 없습니다.",
        "status": 404
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

400: Bad Request 잘못된 요청

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

특정 회원 정보 조회

특정 회원 정보 조회

GET http://localhost:8080/users/{id}

게시물에서 클릭한 유저의 정보를 조회합니다.

Request Body

Name	Type	Description
idx*	Long	게시물을 작성한 유저의 고유 ID

200: OK 유저 정보 조회 성공

{
    "success": true,
    "response": {
        "idx": 1,
        "userId", "rhalstjr1999",
        "userName": "MinseokGo",
        "role": "USER",
        "orderCount": 17,
        "posts": [
            {
                "idx": 1,
                "title": "청학 B동 같이 시켜드실분",
                "createAt": "2023-07-29"
            },
            {
                "idx": 342,
                "title": "가입인사 드립니다.",
                "createAt": "2023-08-03"
            }
        ]        
    },
    "error": null
}

404: Not Found 해당 유저의 정보를 찾을 수 없을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 유저를 찾을 수 없습니다.",
        "status": 404
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

400: Bad Request 잘못된 요청

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

회원 주소 추가

회원 주소 추가

POST http://localhost:8080/users/address/add

회원이 보유하고 있는 주소를 보여줍니다.

Headers

Name	Type	Description
token*	String	로그인 시 발급받은 JWT

Request Body

Name	Type	Description
address*	String	회원이 등록한 주소

200: OK 주소 등록 성공

{
    "success": true,
    "response": null,
    "error": null
}

400: Bad Request 잘못된 요청

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

401: Unauthorized 인증되지 않았을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "인증되지 않았습니다.",
	"status": 401
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

회원 주소 조회

회원 주소 조회

GET http://localhost:8080/users/address

회원이 등록한 주소를 조회합니다.

Headers

Name	Type	Description
token*	String	로그인 시 발급받은 JWT

200: OK 주소 조회 성공

{
    "success": true,
    "response": {
        "addressList": [
            { "address": "연제구 연산동" },
            { "address": "연제구 토곡통" }
        ]
    }
    ,
    "error": null
}

400: Bad Request 잘못된 요청

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

401: Unauthorized 인증되지 않았을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "인증되지 않았습니다.",
	"status": 401
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

회원 정보 수정

회원 정보 수정

PUT http://localhost:8080/users/update

유저의 비밀번호, 닉네임을 수정할 수 있도록 합니다.

비밀번호 변경 시, old, new 패스워드를 모두 입력해야하지만 정보 수정의 경우 닉네임을 변경하지 않을 수도 있기 때문에 Optional로 지정합니다.

닉네임 변경의 경우도 동일합니다.

Headers

Name	Type	Description
token*	String	로그인 시 발급받은 JWT

Request Body

Name	Type	Description
newNickname	String	변경할 닉네임
oldPassword	String	이전 비밀번호
newPassword	String	변경 비밀번호

200: OK 정보 수정 성공

{
    "success": true,
    "response": null,
    "error": null
}

400: Bad Request old, new 비밀번호가 일치하지 않을 경우(프론트에서 한번 체크는 해야함)

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

409: Conflict 중복 닉네임 존재

{
    "success": false,
    "response": null,
    "error": {
        "message": "중복된 닉네임이 존재합니다.",
        "status": 409
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}

401: Unauthorized 인증되지 않았을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "인증되지 않았습니다.",
	"status": 401
    }
}

회원 탈퇴

회원 탈퇴

DELETE http://localhost:8080/users/unregist

회원 탈퇴를 할 수 있도록 합니다.

Headers

Name	Type	Description
token*	String	로그인 시 발급받은 JWT

200: OK 탈퇴 처리 성공

{
    "success": true,
    "response": null,
    "error": null
}

401: Unauthorized 인증되지 않았을 때

{
    "success": false,
    "response": null,
    "error": {
        "message": "인증되지 않았습니다.",
	"status": 401
    }
}

400: Bad Request 잘못된 요청

{
    "success": false,
    "response": null,
    "error": {
        "message": "해당 요청은 잘못되었습니다.",
        "status": 400
    }
}

500: Internal Server Error 서버의 알 수 없는 에러

{
    "success": false,
    "response": null,
    "error": {
        "message": "서버의 알 수 없는 에러입니다.",
        "status": 500
    }
}