상품 리스트 조회 (전체, 카테고리, 브랜드 {with 최신순 인기순} ) - SOPT23-Befit/Befit-Server GitHub Wiki

상품 리스트 조회 (전체, 카테고리, 브랜드 {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
}