상품평 관리

상품평 관련 데이터를 효율적으로 조회하고 관리하기 위한 다양한 기능을 제공합니다. 상품평 목록 조회, 상세 정보 조회, 평가항목 및 고객프로필 관리 등의 기능을 통해 풍부한 상품평 데이터를 유연하게 다룰 수 있습니다.

---

주요 기능

• 상품평 목록 조회

  • 작성 기간, 상품평 구분, 전시 상태, 상품평 신고 여부, 작성 회원ID/회원명, 상품 번호, 상품평 번호 등의 다양한 조건으로 상품평 목록을 효율적으로 조회할 수 있습니다.

• 전시 상태 일괄 변경

  • 조회된 상품평들의 전시 상태를 일괄적으로 변경할 수 있습니다. 전시 처리 및 전시 안함 처리를 편리하게 수행할 수 있습니다.

• 상품평 상세 조회

  • 특정 상품평의 상세 정보를 조회하며, 상품평 내용, 작성 회원ID, 주문번호, 평가항목, 고객 프로필 정보, 상품평 신고 내역 등을 상세하게 확인할 수 있습니다.

• 평가항목 및 고객프로필 관리

  • 표준카테고리에 매핑된 상품평의 평가항목과 고객프로필항목을 조회하고, 상품평 작성 시에 이를 조회하여 추가할 수 있는 기능을 제공합니다.

  • 다국어 등록이 가능한 평가항목과 평가값을 유연하게 관리할 수 있습니다.

프로세스 정의 — 상품평 관리

1

상품평 목록 조회

조회 조건과 일치하는 상품평 목록을 조회합니다. 별도 조회조건 미설정 시 최근 7일 내 작성된 상품평 목록을 리뷰 작성일시 최신순으로 조회합니다.

조회 가능한 조건: 작성 기간, 상품평 구분(텍스트, 사진, 동영상, 사진/동영상), 전시 상태, 상품평 신고 여부, 회원 ID/명, 상품 번호, 상품명

2

상품평 상세 정보 조회

개별 상품평의 상세 정보를 조회합니다.

상품평 목록 그리드에서 상품평 번호 또는 상품평 내용 클릭 시 호출됩니다.

3

상품평 첨부파일 이미지 목록 조회

개별 상품평의 첨부파일 이미지 목록을 조회합니다.

상품평 상세 팝업에서 호출됩니다.

4

상품평 첨부파일 동영상 목록 조회

개별 상품평의 첨부파일 동영상 목록을 조회합니다.

상품평 상세 팝업에서 호출됩니다.

5

상품평 평가항목별 답변 목록 조회

개별 상품평의 평가항목별 답변 목록을 조회합니다.

상품평 상세 팝업에서 호출됩니다.

평가항목 답변은 각 평가항목별로 지정한 평가값에 의해 가능한 목록이 정해집니다.

6

상품별 고객 프로필 답변 목록 조회

개별 상품평의 고객프로필 답변 목록을 조회합니다.

상품평 상세 팝업에서 호출됩니다.

7

상품평 목록 전시상태 변경

상품평 목록에서 선택한 상품평들의 전시상태를 일괄적으로 변경합니다.

8

상품평 전시상태 변경

개별 상품평의 전시상태를 변경합니다.

상품평번호, 상품평 전시상태 코드를 누락한 경우 오류 메시지를 반환합니다.

9

컨텐츠전시상태 변경

상품평 내 컨텐츠 전시상태를 변경합니다.

상품평번호, 컨텐츠 전시상태 코드를 누락한 경우 오류 메시지를 반환합니다.

10

상품평 댓글 목록 조회

개별 상품평에 등록된 댓글 목록을 조회합니다.

11

댓글 목록 전시상태 변경

댓글 목록 전시상태를 변경합니다.

상품평 번호, 댓글 순번, 댓글 전시상태 코드가 필수이며 누락된 경우 오류 메시지를 반환합니다.

12

상품평 댓글 등록

특정 상품평에 댓글을 등록합니다.

필수값이 누락된 경우 오류 메시지를 반환합니다.

• 필수값: 댓글내용, 리뷰번호, 작성자구분코드, 작성자아이디, 댓글전시상태코드, 시스템등록자ID

13

상품평 신고 목록 조회

특정 상품평의 신고 목록을 조회합니다.

프로세스 정의 — 상품평 평가항목 관리

1

평가항목 매핑목록 조회

표준 카테고리와 매핑되는 상품평 평가항목의 매핑목록을 조회합니다.

2

추가대상 평가항목 목록 조회

추가대상 평가항목 목록을 조회합니다.

평가항목명을 조건으로 조회가 가능합니다.

3

평가값 목록 조회

평가항목에 매핑된 평가값 목록을 조회합니다.

4

평가항목 목록 조회

조회 조건과 일치하는 평가항목 목록을 조회합니다.

등록기간과 평가항목을 세부 조건으로 하여 조회가 가능합니다.

5

매핑된 표준카테고리 목록 조회

상품평 평가항목과 매핑된 표준카테고리의 목록을 조회합니다.

6

평가값 목록 조회 (조건별)

조회 조건과 일치하는 평가값 목록을 조회합니다.

등록기간과 평가항목명을 세부조건으로 하여 조회가 가능합니다.

7

평가항목매핑목록 저장

표준카테고리와 매핑되는 평가항목매핑목록을 등록/수정/삭제합니다.

리프 카테고리만 평가항목 매핑이 가능하며, 리프 카테고리 하나당 최대 3개의 평가항목을 매핑 가능합니다.

8

고객프로필항목 매핑목록 저장

고객프로필항목 매핑목록을 등록/수정/삭제합니다.

리프 카테고리 하나당 최대 3개의 고객프로필항목까지 매핑이 가능합니다.

9

고객프로필항목 매핑목록 조회

표준카테고리와 매핑되는 고객프로필항목 매핑목록을 조회합니다.

10

추가대상 고객 프로필 항목 목록 조회

추가대상 고객 프로필 항목 목록을 조회합니다.

고객 프로필 항목명을 조건으로 하여 조회가 가능합니다.

11

평가항목목록 저장

상품평 평가항목의 등록/수정이 가능합니다.

평가항목명이 중복인 경우 오류를 반환합니다.

해당 평가항목의 사용여부를 N으로 변경한 경우, 매핑된 카테고리 연결이 해제됩니다.

12

평가값 목록 저장

선택한 평가항목의 평가값 목록의 등록/수정/삭제가 가능합니다.

프로세스 정의 — 상품평 다국어 관리

1

다국어 평가값 목록 조회

선택한 평가항목의 다국어 평가값 목록을 조회합니다.

2

다국어 평가항목 조회

선택한 평가항목의 다국어 평가항목을 조회합니다.

API 기능 목록

API	설명	Server	메소드	비고
상품평 목록 조회	• 조회 조건과 일치하는 상품평 목록을 조회합니다. • 별도 조회조건 미설정시 최근 7일 내 작성/수정된 상품평 목록을 수정일 역순으로 조회합니다.	Goods	GET	🔗API 확인하기 >
상품평 목록 전시상태 변경	• 상품평 목록에서 선택한 상품평들의 전시상태를 일괄 변경합니다. • 전시 처리와 전시안함 처리가 가능합니다.	Goods	POST	🔗API 확인하기 >
상품평 상세 정보 조회	• 상품평의 상세 정보를 조회합니다. • 상품평 목록 그리드에서 상품평 번호 또는 상품평 내용 클릭시 호출됩니다.	Goods	GET	🔗API 확인하기 >
상품평 첨부 파일 이미지 목록 조회	•상품평의 첨부파일 중 이미지 목록을 조회합니다. •상품평 상세 팝업에서 호출됩니다.	Goods	GET	🔗API 확인하기 >
상품평 첨부 파일 동영상 목록 조회	•상품평의 첨부파일 중 동영상 목록을 조회합니다. •상품평 상세 팝업에서 호출됩니다.	Goods	GET	🔗API 확인하기 >
상품평 평가 항목별 답변 목록 조회	•상품평의 평가항목별 답변 목록을 조회합니다. •상품평 상세 팝업에서 호출됩니다.	Goods	GET	🔗API 확인하기 >
상품평 고객 프로필 답변 목록 조회	•상품평의 고객프로필 답변 목록을 조회합니다. •상품평 상세 팝업에서 호출됩니다.	Goods	GET	🔗API 확인하기 >
상품평 댓글 목록 조회	•개별 상품평의 댓글 목록을 조회합니다.	Goods	GET	🔗API 확인하기 > FO 추가 전까지 해당 API 미사용
상품평 전시상태 변경	• 상품평번호와 상품평 전시상태 코드를 통해 개별 상품평의 전시상태를 변경합니다.	Goods	POST	🔗API 확인하기 >
컨텐츠전시상태 변경	• 상품평번호와 컨텐츠전시상태 코드를 통해 컨텐츠 전시상태를 변경합니다.	Goods	POST	🔗API 확인하기 >
댓글 목록 전시상태 변경	• 상품평번호, 댓글전시상태 코드를 통해 특정 상품평의 댓글 목록의 전시상태를 변경합니다.	Goods	POST	🔗API 확인하기 > FO 추가 전까지 해당 API 미사용
상품평 댓글 등록	• 상품평 댓글을 등록합니다. • 댓글내용, 리뷰번호, 작성자구분코드, 작성자아이디, 댓글전시상태코드, 시스템등록자ID가 필수값입니다.	Goods	POST	🔗API 확인하기 > FO 추가 전까지 해당 API 미사용
상품평 신고 목록 조회	• 개별 상품평의 신고 목록을 조회합니다.	Goods	GET	🔗API 확인하기 >
평가항목 매핑목록 조회	• 상품평의 평가항목 매핑 목록을 조회합니다. • 상품평의 평가항목은 표준 카테고리와 매핑됩니다.	Goods	GET	🔗API 확인하기 >
고객프로필항목 매핑목록 조회	• 상품평의 고객프로필항목 매핑 목록을 조회합니다. • 상품평의 고객프로필항목은 표준 카테고리와 매핑됩니다.	Goods	GET	🔗API 확인하기 >
평가항목매핑목록 저장	• 상품평의 평가항목 매핑목록을 등록/수정/삭제합니다. • 대/중/소/리프 카테고리 중 리프 카테고리에만 평가항목 매핑이 가능합니다.	Goods	POST	🔗API 확인하기 >
고객프로필항목매핑목록 저장	• 상품평에 매핑된 고객프로필항목 목록을 등록/수정/삭제합니다. • 대/중/소/리프 카테고리 중 리프 카테고리에만 평가항목 매핑이 가능합니다.	Goods	POST	🔗API 확인하기 >
추가대상 평가항목 목록 조회	• 추가대상 평가항목 목록을 조회합니다. • 평가항목명 조건으로 조회할 수 있습니다.	Goods	GET	🔗API 확인하기 >
추가대상 고객 프로필 항목 목록 조회	• 추가대상 고객 프로필 항목 목록을 조회합니다. • 고객 프로필 항목명 조건으로 조회할 수 있습니다.	Goods	GET	🔗API 확인하기 >
평가값 목록 조회	• 선택한 평가항목에 해당하는 평가값 목록을 조회합니다.	Goods	GET	🔗API 확인하기 > 표준카테고리 매핑관리>평가항목상세>평가값목록조회
평가항목 목록 조회	• 조회 조건과 일치하는 평가항목 목록을 조회합니다. • 등록기간과 평가항목명으로 조회가 가능합니다.	Goods	GET	🔗API 확인하기 >
평가항목목록 저장	• 상품평의 평가항목을 등록/수정합니다. • 해당 평가항목의 사용여부를 ‘N’으로 변경시 매핑된 카테고리 연결이 해제됩니다.	Goods	POST	🔗API 확인하기 >
매핑된 표준카테고리 목록 조회	• 상품평 평가항목과 매핑된 표준카테고리 목록을 조회합니다.	Goods	GET	🔗API 확인하기 >
평가값 목록 조회	• 선택한 평가항목에 매핑된 평가값 목록을 조회합니다. • 평가항목 선택시 자동으로 조회됩니다.	Goods	GET	🔗API 확인하기 > 평가항목 관리>평가값목록조회
평가값 목록 저장	• 선택한 평가항목에 매핑된 평가값 목록을 등록/수정/삭제합니다. *평가항목 하위의 평가값 목록의 경우 기능상 등록/수정/삭제 모두 가능하지만, 해당 평가항목을 매핑한 후에는 상품 집계 오류 발생 가능성이 있어 평가값 목록을 수정하지 않는 것을 권장합니다.	Goods	POST	🔗API 확인하기 >
다국어 평가값 목록 조회	• 선택한 평가항목의 다국어 평가값 목록을 조회합니다.	Goods	GET	🔗API 확인하기 >
다국어 평가값 목록 저장	• 선택한 평가항목에 매핑된 다국어 평가값 목록을 등록/수정합니다.	Goods	POST	🔗API 확인하기 >
다국어 평가항목 조회	• 선택한 평가항목의 다국어 평가항목 목록을 조회합니다.	Goods	GET	🔗API 확인하기 >
다국어 평가항목 저장	• 선택한 평가항목에 매핑된 다국어 평가항목을 등록/수정합니다.	Goods	POST	🔗API 확인하기 >

용어 정의

명칭	설명
평가항목	• 상품평 작성 시 상품평 작성 대상 상품이 속하는 표준카테고리에 자동 매핑됩니다. • 평가항목은 최대 3개까지 가능하며, 평가항목별로 평가값이 결정됩니다.
평가값	• 상품평 작성 시 고객이 상품을 평가하는 세부 옵션입니다. • 상품평 평가항목에 자동 매핑되며, 등록/수정/삭제가 가능합니다.