상품 리스트 조회 (전체, 카테고리, 브랜드 {with 최신순 인기순} )
메서드 |
경로 |
짧은 설명 |
GET |
/products |
상품 전체 조회 |
GET |
/products/new/category/{category_idx}?gender={gender} |
카테고리 조회, 최신순 |
GET |
/products/popular/category/{category_idx}?gender={gender} |
카테고리 조회, 인기순 |
GET |
/products/new/brand/{brand_idx} |
브랜드 상품 조회, 최신순 |
GET |
/products/popular/brand/{brand_idx} |
브랜드 상품 조회, 인기순 |
QueryString 설명
Parameter |
Type |
필수여부 |
예시 |
기본값 |
gender |
string |
Y |
gender=여성 / gender=남성 |
- |
변수 설명
키값(변수명) |
타입 |
설명 |
idx |
int |
product_idx(상품 고유번호) |
name |
String |
상품 이름 |
price |
String |
상품 가격 |
image_url |
String |
상품 이미지 url |
product_category_index |
int |
상품 카테고리 인덱스 (outer : 0 , jacket : 1 ...) |
brand_idx |
int |
해당 상품 브랜드 고유 번호 |
date |
Date |
상품 등록 일자 |
link |
String |
해당 상품 자사 웹뷰 url |
measure |
Object |
상품 치수 |
like_score |
int |
상품 좋아요 갯수 |
product_like |
int |
로그인 유저의 해당 브랜드 좋아요 유무 0 : x, 1: 좋아요 o |
name_korean |
String |
해당 상품 브랜드 korean 이름 |
name_english |
String |
해당 상품 브랜드 english 이름 |
요청 헤더
Authorization: token
응답 바디
[응답 성공]
상품 전체 조회 성공
{
"status": 200,
"message": "상품 전체 조회 성공",
"data": [
{
{
"idx": 2,
"name": "[5차 딜리버리][UNISEX] 오버핏 버터 플라워 자수 스웻 셔츠 (Black)",
"price": "69,000",
"image_url": "https://image.musinsa.com/images/goods_img/20170125/476242/476242_4_500.jpg",
"product_category_index": 7,
"brand_idx": 1,
"date": "2018-11-06T00:00:00.000+0000",
"link": "m.prairie-store.com/product/4%EC%B0%A8-%EB%94%9C%EB%A6%AC%EB%B2%84%EB%A6%ACunisex-%EC%98%A4%EB%B2%84%ED%95%8F-%EB%B2%84%ED%84%B0-%ED%94%8C%EB%9D%BC%EC%9B%8C-%EC%9E%90%EC%88%98-%EC%8A%A4%EC%9B%BB-%EC%85%94%EC%B8%A0-black/199/category/55/display/1/",
"measure": {
"L": {
"총장": "79.5",
"가슴단면": "66",
"소매길이": "60",
"어깨너비": "64"
},
"M": {
"총장": "77",
"가슴단면": "61",
"소매길이": "58",
"어깨너비": "62"
},
"S": {
"총장": "74",
"가슴단면": "58",
"소매길이": "56.5",
"어깨너비": "59"
}
},
"like_score": 931,
"product_like": 0,
"name_korean": "프레리",
"name_english": "PRAIRIE"
},
{
"idx": 4,
"name": "[UNISEX] 헤비 울 체크 더플코트 (GREEN)",
"price": "249,000",
"image_url": "https://image.musinsa.com/images/goods_img/20180904/846429/846429_2_500.jpg",
"product_category_index": 2,
"brand_idx": 1,
"date": "2018-11-28T00:00:00.000+0000",
"link": "m.prairie-store.com/product/8%EC%B0%A8-%EB%94%9C%EB%A6%AC%EB%B2%84%EB%A6%ACunisex-%EC%B2%B4%ED%81%AC-%ED%97%A4%EB%B9%84-%EC%9A%B8-%EB%93%9C%EB%A1%AD-%EC%88%84%EB%8D%94-%EC%98%A4%EB%B2%84-%EC%BD%94%ED%8A%B8-green/350/category/55/display/1/",
"measure": {
"L": {
"총장": "103",
"가슴단면": "64",
"소매길이": "62",
"어깨너비": "51"
},
"M": {
"총장": "100",
"가슴단면": "61",
"소매길이": "61",
"어깨너비": "49"
},
"S": {
"총장": "97",
"가슴단면": "58",
"소매길이": "60",
"어깨너비": "47"
}
},
"like_score": 115,
"product_like": 0,
"name_korean": "프레리",
"name_english": "PRAIRIE"
}]
}
카테고리 상품 조회 신상순
{
"status": 200,
"message": "카테고리 상품 조회 신상순",
"data": [
{ (위와 같은 양식) }
]
}
카테고리 상품 조회 인기순
{
"status": 200,
"message": " 카테고리 상품 조회 인기순",
"data": [
{ (위와 같은 양식) }
]
}
브랜드 상품 조회 신상순
{
"status": 200,
"message": "브랜드 상품 조회 신상순",
"data": [
{ (위와 같은 양식) }
]
}
브랜드 상품 조회 인기순
{
"status": 200,
"message": "브랜드 상품 조회 인기순",
"data": [
{ (위와 같은 양식) }
]
}
[응답 실패]
모든 상품 리스트 조회 실패
{
"status": 400,
"message": "상품 리스트 조회 실패",
"data": null
}
잘못된 상품 리스트 조회 URL
{
"status": 404,
"message": "잘못된 상품 리스트 조회 URL",
"data": null
}
404 에러 url 맞지 않음 (type 틀리거나, sort 틀림) or category 인덱스 벗어남 or
인증 실패
{
"status": 401,
"message": "인증 실패",
"data": null
}
서버 내부 오류
{
"status": 500,
"message": "서버 내부 에러",
"data": null
}
데이터베이스 에러
{
"status": 600,
"message": "데이터베이스 에러",
"data": null
}