3.상품 조회
누구나 전체 상품 목록을 조회할 수 있음
| 메서드 | URI |
|---|---|
| GET | /api/products |
1-1. 세부 요구사항
- 카테고리 기반 필터링(
category) - 페이징 처리(
page, size) - HATEOAS 링크 포함(
_links)profile: 상품 조회에 대한 API 문서 참조 링크self: 현재 조회한 데이터 자체 APInext: 다음 페이지prev: 이전 페이지
1-2. 쿼리 파라미터
category: 상품 카테고리별 필터링page, size: 페이징 처리(페이지, 사이즈)
1-4. 요청 예시
요청 예시는 다음과 같음
HTTP 요청 포맷
// 카테고리가 전자제품인 상품 중 0페이지의 2개 상품 데이터 조회
GET {host}/api/products?category=전자제품&page=0&size=21-4. 응답 예시
응답 예시는 다음과 같음
JSON 응답 포맷
{
"products": [
{
"id": 1,
"name": "맥북 프로 16인치",
"description": "고성능 M칩을 탑재한 전문가용 노트북",
"price": 3500000,
"stock": 5,
"category": "전자제품",
"userId": 1
},
{
"id": 2,
"name": "에어팟 프로",
"description": "액티브 노이즈 캔슬링이 탑재된 무선 이어폰",
"price": 300000,
"stock": 10,
"category": "전자제품",
"userId": 2
}
],
"_links": {
"profile": {
"rel": "self",
"href": "/swagger-ui/index.html"
},
"self": {
"rel": "self",
"href": "/api/products?page=0&size=2"
},
"next": {
"rel": "self",
"href": "/api/products?page=1&size=2"
}
}
}Last updated on