soominsohn/jwp-shopping-cart

🚀 1단계 - 회원 기능

장바구니 서비스의 회원 기능 구현하기

• 회원가입
  • 아이디 중복이면 예외
• 로그인
  • id, 비밀번호 잘못되었을 때 예외
  • 정상적으로 로그인 될 경우 token과 name 넘긴다.
• 수정
  • 비밀번호가 일치하면 수정 할 수 있다.
  • name 수정 가능하다.
  • 비밀번호가 일치하지 않을 때 예외
• 탈퇴
  • 비밀번호가 일치해야 탈퇴할 수 있다.
  • 비밀번호가 틀릴경우 예외

API 명세

2단계 추가 명세

Products

POST /products

// request
{
	"name": String
	"price": int
	"imageUrl": String
}

// response 201 created
Header {
	"Location": "/products/{productId}"
}

GET /products

// request

//response
200 OK
{
	[
			{
			"id": Long,
			"name": String
			"price": int
			"imageUrl": String
		},
		{
			"id": Long,
			"name": String
			"price": int
			"imageUrl": String
		}
	]
}

단일 아이템 조회

GET /products/{productId}

// request

// response
200 OK
{
"id" : Long
"name": String 
"price": int
"imageUrl": String
}

// productId 없는 경우 404 NOT FOUND

DELETE /products/{productId}

// request

// response
204 No Content

// productId 없는 경우 404 NOT FOUND

---

CartItem

• 장바구니 담기
• 장바구니 삭제
• 장바구니 전체 삭제
• 장바구니 조회

장바구니 담기

POST /customers/me/carts

// request
Header {
 "Authorization": accessToken
}

Body
{
  "productId": Long
}

// response
Header {
	"Location": "/customers/cart/{cartItemId}"
}

201 Created
Body{
	"id" : Long,
	"productId" : Long,
	"name" : String,
	"price" : int, 
	"imageUrl" : String,
	"quantity" : int,
}

// accessToken이 유효하지 않을 경우 401 Unauthorized
// productId가 존재하지 않은 경우 404 Not Found
// 장바구니에 이미 product가 존재하는 경우 400 Bad Request

장바구니 조회

GET /customers/me/carts

// request
Header {
 "Authorization": accessToken
}

//response
200 OK
{
	[
			{
			"id": Long,
			"productId" : Long,
			"name": String
			"price": int
			"imageUrl": String
			"quantity": int
		},
		{
			"id": Long,
			"productId" : Long,
			"name": String
			"price": int
			"imageUrl": String
			"quantity": int
		}
	]
}

// 장바구니에 아무런 상품이 없으면 empty List
// 토큰이 유효하지 않으면 401 Unauthorized

장바구니 삭제

DELETE /customers/me/carts/{cartItemId}

// request
Header {
 "Authorization": accessToken
}

// response
204 No Content

// 토큰이 유효하지 않으면 401 Unauthorized
// cartItemId가 없는 경우 404 NOT FOUND
// productId가 사라져있는 경우 추후 고려

장바구니 전체 삭제

DELETE /customers/me/carts

// request
Header {
 "Authorization": accessToken
}

// response
204 No Content

// 토큰이 유효하지 않으면 401 Unauthorized

장바구니 개수 수정

PUT /customers/me/carts/{cartItemId}

// request
Header {
 "Authorization": accessToken
}

Body
{
  "quantity": int
}

// response
200 ok

Body{
	"id" : Long,
	"productId" : Long,
	"name" : String,
	"price" : int, 
	"imageUrl" : String,
	"quantity" : int,
}

// accessToken이 유효하지 않을 경우 401 Unauthorized
// cartItemId가 존재하지 않은 경우 404 Not Found

---

Order

POST /customers/orders

// request
Header {
 "Authorization": accessToken
}

Body
{
  [
		{
			"cartItemId": Long,
			"quantity": int
		},
		{
			"cartItemId": Long,
			"quantity": int
		},
		...
	]
}

// response
Header {
	"Location": "/customers/orders/{orderId}"
}

// accessToken이 유효하지 않을 경우 401 Unauthorized
// cartItemId가 존재하지 않은 경우 404 Not Found
// quantity가 0 이하인 경우 400 Bad Request

단일 주문 내역 조회

GET /customers/orders/{orderId}

// request
Header {
 "Authorization": accessToken
}

// response
200 OK
{
	"id" : Long,
	"orderDetails" : [
		{
			"productId": Long
			"quantity" : int
	    "price" : int
			"name" : String
	    "imageUrl" : String
		},
		{
			"productId": Long
			"quantity" : int
	    "price" : int
			"name" : String
	    "imageUrl" : String
		},
		// ...
	]
}

// accessToken이 유효하지 않을 경우 401 Unauthorized
// orderId 없는 경우 404 NOT FOUND
// customer가 orderId에 대한 권한이 없는 경우 401 Unauthorized (그니까 내 주문 내역을 남이 보려고 할때)

GET /customers/orders

*/*/ request
Header {
 "Authorization": accessToken
}

// response
200 OK
{
	[
		"id" : Long,
		"orderDetails" : [
			{
				"productId": Long
				"quantity" : int
		    "price" : int
				"name" : String
		    "imageUrl" : String
			},
			{
				"productId": Long
				"quantity" : int
		    "price" : int
				"name" : String
		    "imageUrl" : String
			}
		]
	],
	[
		"id" : Long,
		"orderDetails" : [
			{
				"productId": Long
				"quantity" : int
		    "price" : int
				"name" : String
		    "imageUrl" : String
			},
			{
				"productId": Long
				"quantity" : int
		    "price" : int
				"name" : String
		    "imageUrl" : String
			}
		]
	]
	// ...
}

// accessToken이 유효하지 않을 경우 401 Unauthorized

• 백엔드
  • 1단계
    • 회원가입
    • 로그인
    • 수정
    • 탈퇴

회원가입

POST /customers

// request
{
  "loginId": string,
  "name": string,
  "password": string
}

// response

// HEADER
// Location: "/customers/me"

// 201
{
	"loginId": string,
	"name": string
}

// 400 Bad Request

로그인

POST /login

// request
{
 	"loginId": string,
	"password": string
}

// response 

// 200
{
 	"accessToken": string,
	"name": string
}

// 401 Unauthorized (로그인 실패)

• id, 비밀번호 잘못되었을 때

정보 조회

GET /customers/me

headers: {
      Authorization: `Bearer ${accessToken}`,
},

// 200 OK response

{
	"loginId": string, 
	"name": string
}

//401 Unauthorized
//토큰이 유효하지 않은 경우

//404 Not Found
//존재하지 않는 회원일 경우

// 현재는 body에 String으로 오류 메세지가 response 됨
{
	"조회 실패!" // 2차에서는 JSON객체로 보내자
}

수정

PUT /customers/me

// response

// 200
{
	"name": string
}

// 400 Bad Request
// 비밀번호 일치하지 않을때
// 아이디가 이메일 형식이 아닐 때

// 404 Not Found
// 존재하지 않는 회원일 때

1. 들어가서 수정하고 비밀번호 쳐야 확정

headers: {
      Authorization: `Bearer ${accessToken}`,
},

// request

{
	"loginId": string, 
	"name": string,
	"password": string // 수정 확정용 비밀번호 
}

탈퇴

DELETE /customers/me

• 탈퇴를 비밀번호 한번 더 치고 탈퇴시키기

headers: {
      Authorization: `Bearer ${accessToken}`,
},

// request

{
	"password": string,
}

// response 

**// 204 no content**

// 400 Bad Request
// 비밀번호 일치하지 않을때

// 404 Not Found
// 존재하지 않는 회원일 경우

//토큰이 존재하지 않는 경우