상품평

상품평 API는 상품번호(goodsNo), 회원번호(mbrNo), 리뷰번호(revNo)를 이용하여 상품평을 등록, 수정, 조회 하는 기능을 제공합니다.

상품평 등록 시 상품평 마일리지 적립이 되도록 회원 API를 호출하여 처리하고 있습니다.

상품평 조회 시 상품평 리스트, 단 건 상세조회, 요약정보 조회 등의 기능을 제공하여 front에서 필요에 따라 상품평 정보를 시각화할 수 있습니다.

상품평 신고 처리, 도움돼요 등록 기능을 제공합니다.

주요 기능

상품평 등록 시 상품평 정보, 상품평 평가항목, 멤버 프로필 정보, 상품평 컨텐츠 정보를 저장합니다.
조회 조건에 따라 회원번호, 상품번호, 리뷰번호 중 하나를 이용하여 상품평 목록을 조회하는 기능을 제공합니다.
상품평 조회 시 상품평 정보, 상품평 평가항목, 멤버 프로필 정보, 상품평 컨텐츠 정보를 조회합니다.
상품에 최근 등록된 상품평의 사진, 동영상 썸네일 리스트를 조회하는 기능을 제공합니다.
상품별 상품평 요약정보 조회 기능을 제공합니다.
상품 카테고리에 따라 상품평에 작성할 평가정보리스트, 고객 프로필리스트를 조회합니다.
작성한 상품평을 수정, 삭제하는 기능을 제공합니다.
상품평 도움돼요를 등록하는 기능을 제공합니다.
상품평 신고 기능을 제공합니다.

프로세스 정의

번호	구분	설명
1	회원별 상품평 목록 조회	회원이 작성한 상품평 목록을 조회합니다. 별도 조회조건 미설정시 최근 1개월 내 작성된 상품평 목록을 조회합니다.
2	상품평 수정	회원이 기존에 작성했던 상품평을 수정합니다. 마이페이지의 작성한 상품평 화면에서 상품평 수정시 호출됩니다. 리뷰번호를 파라미터로 받아서 해당 리뷰번호에 해당하는 상품평을 수정합니다. 회원정보를 확인하여 본인이 작성한 상품평만 수정이 가능합니다.
3	상품평 등록	마이페이지 활동현황 내 작성가능 상품평 화면에서 상품평작성을 통해 상품평 등록시 호출됩니다. 회원정보를 확인하여 본인이 주문한 상품에 대해서만 상품평 작성이 가능합니다. 동일 상품에 대해서는 한 건만 상품평 작성이 가능하며, 리뷰작성여부로 확인합니다. 적립기한 내 상품평을 작성할 경우 마일리지가 지급됩니다.
4	리뷰번호별 상품평 목록 조회(전시제공)	상품번호를 파라미터로 받아 상품의 상품평 목록을 조회합니다. 상품상세 페이지 진입시 하단 상품평 영역에 상품평 정보 노출을 위해 호출됩니다.
5	상품평 상세 내역 조회	상품평 수정시 기존 상품Q&A 정보를 불러오기 위해 호출합니다. 리뷰번호를 파라미터로 받아 단일 상품평의 상세내용을 조회합니다.
6	상품별 상품평 목록 조회	상품 리뷰번호를 통해 해당 리뷰번호에 해당하는 상품평 정보를 조회합니다. 전시 모듈에 제공되며, 코너 콘텐츠 상세 정보 조회시 호출됩니다.
7	최근 등록 상품평 컨텐츠 조회	최근 작성된 사진/동영상 첨부 상품평의 썸네일을 조회합니다. 상품상세 화면 하단 상품평 정보 영역과, 상품별 상품평 목록 화면 상단에 사진/동영상 상품평의 썸네일을 노출하기 위해 호출합니다. 각 상품평 별로 1개의 썸네일이 조회되며, 총 개수가 4개가 넘을 경우 더보기 버튼이 호출됩니다.
8	상품평 삭제	마이페이지의 작성한 상품평 화면에서 상품평 삭제시 호출됩니다. 회원정보를 확인하여 본인이 작성한 상품평만 삭제가 가능합니다. 상품평을 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게 합니다.
9	상품평 평가항목, 고객프로필 조회	카테고리별 평가정보리스트, 고객 프로필리스트를 조회합니다. 상품평 등록 화면에서 해당 상품과 매핑된 평가항목과 표준 카테고리를 나타내기 위해 호출됩니다.
10	상품평 신고 처리	리뷰번호를 파라미터로 받아 상품평을 신고합니다. 본인이 작성하지 않은 상품평만 신고할 수 있습니다.
11	상품평 도움돼요 등록	상품평 도움돼요를 등록하고 해당 상품평의 총 도움돼요 개수를 조회합니다. 상품평 회원정보를 확인하여 본인이 작성하지 않은 상품평만 도움돼요가 가능합니다.
12	상품별 상품평 요약정보 조회	해당 상품의 총 상품평 갯수, 평점, 평가통계, 평가통계 디테일을 조회합니다. 상품상세 화면 하단 상품평 정보 영역에 해당 상품의 상품평 토탈 정보 노출을 위해 호출됩니다.

API 기능 목록

API	설명	Server	매소드	비고
회원별 상품평 목록 조회	회원이 작성한 상품평 목록을 조회합니다. 별도 조회조건 미설정시 최근 1개월 내 작성된 상품평 목록을 조회합니다.	Goods	POST
상품평 수정	회원이 기존에 작성했던 상품평을 수정합니다 마이페이지의 작성한 상품평 화면에서 상품평 수정시 호출됩니다	Goods	POST
상품평 신고 처리	리뷰번호를 파라미터로 받아 상품평을 신고합니다. 본인이 작성하지 않은 상품평만 신고할 수 있습니다.	Goods	POST
상품평 등록	마이페이지 활동현황 내 작성가능 상품평 화면에서 상품평작성을 통해 상품평 등록시 호출됩니다 회원정보를 확인하여 본인이 주문한 상품에 대해서만 상품평 작성이 가능합니다.	Goods	POST	/v1/review/insertRev/{goodsNo} 마일리지 사용/적립 처리 : /api/member/v1/mileage/mlgSaveUse
상품평 도움돼요 등록	상품평 도움돼요를 등록하고 해당 상품평의 총 도움돼요 개수를 조회합니다. 상품평 회원정보를 확인하여 본인이 작성하지 않은 상품평만 도움돼요가 가능합니다.	Goods	GET
상품별 상품평 요약정보 조회	해당 상품의 총 상품평 갯수, 평점, 평가통계, 평가통계 디테일을 조회합니다 상품상세 화면 하단 상품평 정보 영역에 해당 상품의 상품평 토탈 정보 노출을 위해 호출됩니다	Goods	GET
리뷰번호별 상품평 목록 조회(전시제공)	상품번호를 파라미터로 받아 상품의 상품평 목록을 조회합니다. 상품상세 페이지 진입시 하단 상품평 영역에 상품평 정보노출을 위해 호출됩니다	Goods	GET
상품평 상세내역 조회	상품평 수정시 기존 상품평 정보를 불러오기 위해 호출합니다. 리뷰번호를 파라미터로 받아 단일 상품평의 상세내용을조회합니다.	Goods	GET
상품별 상품평 목록 조회	상품 리뷰번호를 통해 해당 리뷰번호에 해당하는 상품평정보를 조회합니다. 전시 모듈에 제공되며, 코너 콘텐츠 상세 정보 조회시 호출됩니다.	Goods	GET
최근 등록 상품평 컨텐츠 조회	최근 작성된 사진/동영상 첨부 상품평의 썸네일을 조회합니다. 상품상세 화면 하단 상품평 정보 영역과, 상품별 상품평목록 화면 상단에 사진/동영상 상품평의 썸네일을 노출하기 위해 호출합니다	Goods	GET
상품평 평가항목, 고객프로필 조회	상품에 매핑된 카테고리별 평가정보리스트, 고객 프로필리스트를 조회합니다. 상품평 등록 화면에서 해당 상품과 매핑된 평가항목과 표준 카테고리를 나타내기 위해 호출됩니다.	Goods	GET
상품평 삭제	마이페이지의 작성한 상품평 화면에서 상품평 삭제시 호출됩니다. 회원정보를 확인하여 본인이 작성한 상품평만 삭제가 가능합니다. 상품평을 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게 합니다.	Goods	GET

용어 정의

명칭	설명	비고
상품	상거래 채널을 통해 판매의 대상이 되는 모든 재화를 의미합니다. 상품을 전시하는 기본 단위이며 상품 상세 화면을 구성하는 기본 단위가 됩니다. 상품은 가격을 관리하는 단위입니다.
단품	상품 하위의 최소 관리 단위로 상품 재고 및 판매의 최소 단위, 즉 고객이 구입하게 되는 단위입니다. 고객의 선택 옵션에 따른, 주문 상품 정보를 관리하는 단위입니다. 재고를 관리하는 단위입니다. (솔루션에서 재고는 ‘웹재고’를 의미합니다.) 옵션의 조합으로 단품 정보가 생성됩니다. (예) 단품A : 컬러-블랙/사이즈-260 / 단품B : 컬러-블랙/사이즈-250
일반상품 (구분)	일반적인 배송이 이루어지는 모든 재화 상품을 의미합니다.
일반상품	단품에 상품의 옵션을 코드화에서 관리하는 상품을 의미합니다. 재고 차감은 단품 단위로 이루어 집니다.