버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

상품평 API는 상품번호(goodsNo), 회원번호(mbrNo), 리뷰번호(revNo)를 이용하여 상품평을 등록, 수정, 조회 하는 조회하는 기능을 제공합니다. 상품평 등록 시에는 상품평 마일리지 적립이 되도록 회원 API를 호출하여 처리하고 있습니다.이루어지며, 상품평 조회 시에는 상품평 리스트, 단 건 상세조회, 요약정보 조회 등의 기능을 제공하여 front에서 필요에 따라 등을 지원하여 front에서 상품평 정보를 시각화할 수 있습니다. 또한, 상품평 신고 처리, 처리와 도움돼요 등록 기능을 제공합니다포함합니다.

...

주요 기능

  • 상품평 등록

    • 상품평 등록 시 상품평 정보, 상품평 평가항목, 멤버 프로필 정보, 상품평 컨텐츠 정보를 저장합니다.

    • 회원 API를 호출하여 상품평 마일리지 적립을 처리합니다.

  • 조회 조건에 따라 상품평 조회

    • 상품평 목록 조회: 회원번호, 상품번호, 리뷰번호 중 하나를 이용하여 상품평 목록을

    조회하는 기능을 제공합니다
    • 조회합니다.

    • 상품평

    조회 시
    • 상세조회: 상품평 정보, 상품평 평가항목, 멤버 프로필 정보, 상품평 컨텐츠 정보를 조회합니다.

    상품에
    • 최근 등록된 상품평의 사진, 동영상 썸네일 리스트 조회: 상품별로 최근 등록된 상품평의 사진, 동영상 썸네일 리스트를

    조회하는 기능을 제공합니다
    • 조회합니다.

    • 상품별 상품평 요약정보 조회

    기능을 제공합니다.
    • : 상품 카테고리에 따라

    상품평에 작성할 평가정보리스트, 고객 프로필리스트를
    • 상품평 요약정보를 조회합니다.

  • 상품평 수정 및 삭제

    • 상품평 수정: 작성한 상품평을 수정하는 기능을 제공합니다.

    • 상품평 삭제: 작성한 상품평을

    수정,
    • 삭제하는 기능을 제공합니다.

  • 기타 기능

    • 상품평 도움돼요 등록: 상품평 도움돼요를 등록하는 기능을 제공합니다.

    • 상품평 신고: 부적절한 상품평에 대해 신고하는 기능을 제공합니다.

프로세스 정의

...

번호

구분

설명

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

...