7.상품 주문
인증된 사용자는 상품을 주문할 수 있음
| 메서드 | URI |
|---|---|
| POST | /api/orders |
1-1. 세부 요구사항
- 인증된 사용자만 상품 주문 가능(JWT 기반,
Bearer) - HATEOAS 링크 포함(
_links)profile: 상품 주문에 대한 API 문서 참조 링크self: 방금 생성된 주문에 대한 주문 내역 상세 조회 링크(GET: /api/orders/{orderId})product: 주문한 상품의 상세 조회 링크(GET: /api/products/{productId})list-products: 전체 상품 목록 조회 링크
1-2. 요청 예시
요청 예시는 다음과 같음
JSON 요청 포맷
{
"productId": 1,
"quantity": 2
}1-3. 응답 예시
응답 예시는 다음과 같음
주문 id와 HATEOAS 링크가 응답됨
JSON 응답 포맷
{
"orderId": 10,
"_links": {
"self": {
"href": "/api/orders/10"
},
"profile": {
"href": "/swagger-ui/index.html"
}
"product": {
"href": "/api/products/1"
},
"list-products": {
"href": "/api/products"
},
}
}
1-4. 응답 코드
- 201 Created: 주문 성공
- 400 Bad Request: 유효성 실패 또는 재고 부족
- 401 Unauthorized: 인증 실패
- 403 Forbidden: 권한 없음
Last updated on