> For the complete documentation index, see [llms.txt](https://workspace-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-post/product-review.md).

# 상품후기

상품후기는 어드민 아래 경로에서 설정이 가능합니다. 

```
shop by basic/pro : 게시판 > 게시판 관리 > 상품후기> 상품후기 설정(탭)
shop by premium : 상품관리 > 상품평 관리 > 상품문의 설정(탭)
```

상품후기는 회원만 작성 가능하며, 비회원은 작성이 불가 합니다.\
비밀 글쓰기는 제공되지 않으며, 상품 후기는 답글 기능도 제공되지 않습니다.\
첨부파일 기능은 어드민 설정에 따릅니다.

<figure><img src="/files/yOe4P6gAnMEpmrtrmRdc" alt=""><figcaption></figcaption></figure>

#### ◼︎ 상품후기 관리 <a href="#undefined" id="undefined"></a>

상품 후기 메뉴 접근 시 상품 후기 목록을 조회합니다.

> [GET /category/product-reviews](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/get-category-product-reviews)
>
> ▶ 카테고리 상품평 목록 조회하기\
> 카테고리 별 상품평 목록을 조회합니다.

기본 스킨의 경우 게시판은 카드형으로 제공하고 있으며, 아래의 항목으로 리스트를 구성합니다.

* 상품 정보 (상품 썸네일 / 상품명 / 옵션명)
* 별점
* 작성일
* 후기정보 (후기 내용 / 첨부파일 여부)
* 작성 가능 후기 버튼

후기 작성하기 버튼의 경우 클릭 시 후기 작성 페이지로 이동하며, 작성 가능한 후기 개수에 대해 카운트 하여 출력합니다.

> [GET /profile/order-options/product-reviewable](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/get-product-reviewable)
>
> ▶ 내 상품평 작성 가능 목록 조회하기\
> 회원이 작성 가능한 후기 목록을 조회합니다.

작성 가능한 상품 후기 목록은 구매한 상품의 옵션 기준으로 출력됩니다.\
버튼 클릭 시 상품 후기 등록 팝업이 출력됩니다.&#x20;

상품 후기 목록에서 상품 썸네일 하단 영역을 클릭하면 상품 후기 상세 페이지로 이동합니다.\
상품 후기 상세 페이지는 아래 API 를 통해 조회 가능합니다.

> [GET /products/{productNo}/product-reviews/{reviewNo}](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/get-products-product-reviews)
>
> ▶ 상품평 가져오기\
> 상품평을 조회합니다.

상품 후기 조회 시 해당 회원이 등록한 상품 후기를 조회해야 하기 때문에 회원 엑세스 토큰 accessToken 값을 포함하여 요청합니다.\
회원 본인이 작성한 상품 후기에 대해서 '수정' 및 '삭제' 기능을 제공합니다.\
수정/ 삭제에 관한 내용은 아래에서 참고 부탁드립니다.

<figure><img src="/files/yWNCJEE5uLGcinlcNLwe" alt=""><figcaption></figcaption></figure>

#### ◼︎ 상품후기 등록 <a href="#undefined" id="undefined"></a>

<figure><img src="/files/5WqPCwoDr36tStkHEpYn" alt=""><figcaption></figcaption></figure>

기본 스킨에서는 상품후기 등록 팝업에서 아래의 항목을 제공합니다.

* 주문 상품 선택 : 게시글 등록 시 상품후기 등록 가능한 주문상품(옵션 기준)을 선택해야 합니다.
* 평점 : 1점 \~5점까지 설정 가능합니다.
* 내용 : 최대 1000자 입력 가능합니다.
* 첨부파일 : 첨부파일은 이미지파일 최대 10개까지 등록 가능하며, 1개당 용량은 5MB로 제한됩니다.

\[상품 선택] 버튼 클릭 시 주문상품을 선택할 수 있는 팝업이 출력됩니다.

<figure><img src="/files/o9aB5aiHOdLAMu1wz0sG" alt=""><figcaption></figcaption></figure>

> [GET /profile/order-options/product-reviewable](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/get-profile-product-reviews)
>
> ► 작성 가능한 상품후기 목록 조회\
> 회원이 작성 가능한 후기 목록을 조회합니다.

작성가능한 상품후기 목록 조회하기 API로 응답 받은 구매정보를 통해 상품 후기 등록가능한 구매상품을 출력합니다.

구매상품 선택 페이지에서 선택한 구매상품을 상품 후기 등록 페이지 내 주문상품 영역에 출력합니다.&#x20;

> [POST /products/{productNo}/product-reviews](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/post-product-reviews)
>
> ▶ 상품평 등록하기\
> 상품평을 등록합니다.

#### ◼︎ 상품후기 수정 <a href="#undefined" id="undefined"></a>

상품후기 수정을 위해서는 아래의 단계로 진행됩니다.

1. 특정 상품 후기 조회
2. 조회한 상품 후기를 상품 후기 수정페이지 내 출력
3. 상품 후기 수정
4. 상품 후기 수정 API 호출

먼저 앞서 상품 후기 상세 페이지 구성 시 언급한 상품 후기 조회하기 API (하이퍼링크를 통한 앵커 처리) 를 통해 특정 상품 후기 내용을 조회합니다.\
이후, 회원이 상품 후기 등록페이지를 통해 수정한 내용을 아래의 API 를 호출하여 등록합니다.

> [PUT /products/{productNo}/product-reviews/{reviewNo}](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/put-product-review)
>
> ▶ 상품후기 수정하기\
> 상품 후기를 수정합니다.

상품 후기는 작성자 본인만 수정 가능하여 회원 엑세스 토큰 accessToken 은 요청 시 필수로 입력해야 합니다.\
수정이 가능한 범위는 주문상품, 평점, 내용, 첨부파일 에 대해 수정이 가능합니다.

#### ◼︎ 상품후기 삭제

> [DELETE /products//{productNo}/product-reviews/{reviewNo}](https://docs.shopby.co.kr/?url.primaryName=display/#/Review/delete-product-review)
>
> ▶ 상품후기 삭제하기
>
> 특정 상품후기를 삭제합니다.

상품 후기 삭제는 상품후기 상세 페이지에서 기능 제공합니다.\
상품 후기는 작성자만 삭제 가능하여 요청 시 회원 엑세스 토큰accessToken을 필수값으로 전송해야 합니다.