> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/goods-api/undefined.md).
# 상품 리뷰 관리
## 상품리뷰 단건 조회
> \## 기능설명\
> \* 상품리뷰 단건 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품번호를 파라미터로 받아 상품리뷰 상세 정보를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReviewBase":{"type":"object","description":"상품리뷰 기본정보 DTO","properties":{"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"revCont":{"type":"string","description":"리뷰내용"},"revScrVal":{"type":"number","format":"float","description":"리뷰별점"},"stfd1Yn":{"type":"string","description":"만족도1여부(배송)"},"stfd2Yn":{"type":"string","description":"만족도2여부(응대)"},"stfd3Yn":{"type":"string","description":"만족도3여부"},"contents":{"type":"array","description":"리뷰콘텐츠목록","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"상품리뷰평가","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"상품리뷰 콘텐츠 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"콘텐츠파일경로"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"전시순서"},"contentCnt":{"type":"integer","format":"int64","description":"리뷰콘텐츠수"},"status":{"type":"string","description":"콘텐츠 상태 C: 등록, U: 수정, D: 삭제"},"fileContentsYn":{"type":"string","description":"파일 포함 여부 (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"상품리뷰 평가 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltVal":{"type":"string","description":"평가값명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"repValueYn":{"type":"string","description":"대표평가값"},"evltValPrcnt":{"type":"integer","format":"int64","description":"평가백분율"}}}}},"paths":{"/v1/review/adv/{revNo}":{"get":{"tags":["상품 리뷰 관리"],"summary":"상품리뷰 단건 조회","description":"## 기능설명\n* 상품리뷰 단건 정보를 조회합니다.\n---\n## 상세설명\n* 상품번호를 파라미터로 받아 상품리뷰 상세 정보를 조회합니다.\n","operationId":"getReview","parameters":[{"name":"revNo","in":"path","description":"리뷰번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품평 정보 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}}},"900":{"description":"상품평 정보 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}}}}}}}}
```
## 상품리뷰 수정
> \## 기능설명\
> \* 상품평을 수정하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 회원이 기존에 작성했던 상품평을 수정합니다.\
> \* 마이페이지의 작성한 상품평 화면에서 상품평 수정시 호출됩니다.\
> \* 리뷰번호를 파라미터로 받아서 해당 리뷰번호에 해당하는 상품평을 수정합니다.\
> \* 회원정보를 확인하여 본인이 작성한 상품평만 수정이 가능합니다.\
> \---\
> \## 검증내용\
> \* 0000 : 상품평이 성공적으로 수정된 경우입니다.\
> \* 5002 : request에 회원번호가 없는 경우 발생합니다. 로그아웃 상태에서 상품평 수정 요청시 발생하는 에러입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 상품평 작성 여부 수정 API 호출시 필수값 세팅 오류 수정
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReviewBase":{"type":"object","description":"상품리뷰 기본정보 DTO","properties":{"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"revCont":{"type":"string","description":"리뷰내용"},"revScrVal":{"type":"number","format":"float","description":"리뷰별점"},"stfd1Yn":{"type":"string","description":"만족도1여부(배송)"},"stfd2Yn":{"type":"string","description":"만족도2여부(응대)"},"stfd3Yn":{"type":"string","description":"만족도3여부"},"contents":{"type":"array","description":"리뷰콘텐츠목록","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"상품리뷰평가","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"상품리뷰 콘텐츠 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"콘텐츠파일경로"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"전시순서"},"contentCnt":{"type":"integer","format":"int64","description":"리뷰콘텐츠수"},"status":{"type":"string","description":"콘텐츠 상태 C: 등록, U: 수정, D: 삭제"},"fileContentsYn":{"type":"string","description":"파일 포함 여부 (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"상품리뷰 평가 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltVal":{"type":"string","description":"평가값명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"repValueYn":{"type":"string","description":"대표평가값"},"evltValPrcnt":{"type":"integer","format":"int64","description":"평가백분율"}}},"ResponseVoid":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/{revNo}":{"put":{"tags":["상품 리뷰 관리"],"summary":"상품리뷰 수정","description":"## 기능설명\n* 상품평을 수정하는 API 입니다.\n---\n## 상세설명\n* 회원이 기존에 작성했던 상품평을 수정합니다.\n* 마이페이지의 작성한 상품평 화면에서 상품평 수정시 호출됩니다.\n* 리뷰번호를 파라미터로 받아서 해당 리뷰번호에 해당하는 상품평을 수정합니다.\n* 회원정보를 확인하여 본인이 작성한 상품평만 수정이 가능합니다.\n---\n## 검증내용\n* 0000 : 상품평이 성공적으로 수정된 경우입니다.\n* 5002 : request에 회원번호가 없는 경우 발생합니다. 로그아웃 상태에서 상품평 수정 요청시 발생하는 에러입니다.\n---\n## 수정번호\n* Release v2.00_240425: 상품평 작성 여부 수정 API 호출시 필수값 세팅 오류 수정\n","operationId":"modifyReview","parameters":[{"name":"revNo","in":"path","description":"리뷰번호","required":true,"schema":{"type":"string"}},{"name":"files","in":"query","description":"멀티미디어 정보","schema":{"type":"string","format":"binary"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"description":"등록 리뷰 정보","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}},"required":true},"responses":{"200":{"description":"상품평 수정 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"상품평 수정 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품평 삭제
> \## 기능설명\
> \* 상품평을 삭제하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 마이페이지의 작성한 상품평 화면에서 상품평 삭제시 호출됩니다.\
> \* 회원정보를 확인하여 본인이 작성한 상품평만 삭제가 가능합니다.\
> \* 상품평을 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게합니다.\
> \---\
> \## 검증내용\
> \* 0000 : 상품평이 성공적으로 삭제된 경우입니다.\
> \* 5000 : 회원 정보가 없는 상태에서 상품평 삭제시 발생합니다. 로그아웃 상태에서 상품평 신고 요청시 발생하는 에러입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/{revNo}":{"delete":{"tags":["상품 리뷰 관리"],"summary":"상품평 삭제","description":"## 기능설명\n* 상품평을 삭제하는 API 입니다.\n---\n## 상세설명\n* 마이페이지의 작성한 상품평 화면에서 상품평 삭제시 호출됩니다.\n* 회원정보를 확인하여 본인이 작성한 상품평만 삭제가 가능합니다.\n* 상품평을 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게합니다.\n---\n## 검증내용\n* 0000 : 상품평이 성공적으로 삭제된 경우입니다.\n* 5000 : 회원 정보가 없는 상태에서 상품평 삭제시 발생합니다. 로그아웃 상태에서 상품평 신고 요청시 발생하는 에러입니다.\n","operationId":"deleteReview","parameters":[{"name":"revNo","in":"path","description":"리뷰번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품평 삭제 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}},"900":{"description":"상품평 삭제 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품평 도움돼요 업데이트 및 총 개수 조회
> \## 기능설명\
> \* 상품평 도움돼요를 업데이트하고 해당 상품평의 총 도움돼요 개수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품평 도움돼요를 업데이트하고 해당 상품평의 총 도움돼요 개수를 조회합니다.\
> \* 상품평 회원정보를 확인하여 본인이 작성하지 않은 상품평만 도움돼요가 가능합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReviewHelpful":{"type":"object","description":"상품리뷰도움돼요 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"mbrNo":{"type":"string","description":"회원번호"},"delYn":{"type":"string","description":"삭제여부"},"hlpfulCnt":{"type":"integer","format":"int32","description":"도움돼요수"}}}}},"paths":{"/v1/review/adv/helpful/{revNo}":{"post":{"tags":["상품 리뷰 관리"],"summary":"상품평 도움돼요 업데이트 및 총 개수 조회","description":"## 기능설명\n* 상품평 도움돼요를 업데이트하고 해당 상품평의 총 도움돼요 개수를 조회합니다.\n---\n## 상세설명\n* 상품평 도움돼요를 업데이트하고 해당 상품평의 총 도움돼요 개수를 조회합니다.\n* 상품평 회원정보를 확인하여 본인이 작성하지 않은 상품평만 도움돼요가 가능합니다.\n","operationId":"updateAndGetReviewHelpful","parameters":[{"name":"revNo","in":"path","description":"리뷰번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GoodsReviewHelpful"}}}}}}}}}
```
## 상품별 상품평 정보 조회
> \## 기능설명\
> \* 상품별 상품평 목록 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품번호를 파라미터로 받아 상품의 상품평 목록을 조회합니다.\
> \* 상품상세 페이지 진입시 하단 상품평 영역에 상품평 정보 노출을 위해 호출됩니다.\
> \* 구분 리뷰 개수 조회 시 리뷰구분코드목록이 존재할 경우 구분 리뷰 개수가 조회되지 않습니다.\
> \---\
> \## 코드정리\
> \* \`\`\` 정렬유형코드 \`\`\` : latest:최신순, recommend:추천순
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReview":{"type":"object","description":"상품 리뷰 DTO","properties":{"goods":{"$ref":"#/components/schemas/GoodsBase","description":"상품정보"},"review":{"$ref":"#/components/schemas/GoodsReviewBase","description":"리뷰정보"},"reviewListData":{"$ref":"#/components/schemas/GoodsReviewListDataGoodsReviewBase","description":"리뷰목록정보"}}},"GoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"brandNm":{"type":"string","description":"브랜드명"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"GoodsReviewBase":{"type":"object","description":"상품리뷰 기본정보 DTO","properties":{"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"revCont":{"type":"string","description":"리뷰내용"},"revScrVal":{"type":"number","format":"float","description":"리뷰별점"},"stfd1Yn":{"type":"string","description":"만족도1여부(배송)"},"stfd2Yn":{"type":"string","description":"만족도2여부(응대)"},"stfd3Yn":{"type":"string","description":"만족도3여부"},"contents":{"type":"array","description":"리뷰콘텐츠목록","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"상품리뷰평가","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"상품리뷰 콘텐츠 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"콘텐츠파일경로"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"전시순서"},"contentCnt":{"type":"integer","format":"int64","description":"리뷰콘텐츠수"},"status":{"type":"string","description":"콘텐츠 상태 C: 등록, U: 수정, D: 삭제"},"fileContentsYn":{"type":"string","description":"파일 포함 여부 (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"상품리뷰 평가 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltVal":{"type":"string","description":"평가값명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"repValueYn":{"type":"string","description":"대표평가값"},"evltValPrcnt":{"type":"integer","format":"int64","description":"평가백분율"}}},"GoodsReviewListDataGoodsReviewBase":{"type":"object","description":"상품리뷰 목록 DTO","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsReviewBase"}},"totalCnt":{"type":"integer","format":"int64"},"textRevCnt":{"type":"integer","format":"int64","description":"텍스트 리뷰 개수"},"photoVideoRevCnt":{"type":"integer","format":"int64","description":"포토/동영상 리뷰 개수"}}}}},"paths":{"/v1/review/adv/goods/{goodsNo}":{"get":{"tags":["상품 리뷰 관리"],"summary":"상품별 상품평 정보 조회","description":"## 기능설명\n* 상품별 상품평 목록 정보를 조회합니다.\n---\n## 상세설명\n* 상품번호를 파라미터로 받아 상품의 상품평 목록을 조회합니다.\n* 상품상세 페이지 진입시 하단 상품평 영역에 상품평 정보 노출을 위해 호출됩니다.\n* 구분 리뷰 개수 조회 시 리뷰구분코드목록이 존재할 경우 구분 리뷰 개수가 조회되지 않습니다.\n---\n## 코드정리\n* ``` 정렬유형코드 ``` : latest:최신순, recommend:추천순\n","operationId":"getGoodsInfoAndReviewList","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string"}},{"name":"revGbCdList","in":"query","description":"리뷰구분코드목록","schema":{"type":"array"}},{"name":"sortTypeCd","in":"query","description":"정렬유형코드","schema":{"type":"string"}},{"name":"typeCountYn","in":"query","description":"구분 리뷰 개수 여부","schema":{"type":"string"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품별 상품평 정보 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}},"900":{"description":"상품별 상품평 정보 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}}}}}}}
````
## 상품리뷰 등록
> \## 기능설명\
> \* 상품평을 등록하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 회원이 구매한 상품의 상품평을 등록합니다.\
> \* 마이페이지의 작성 가능 상품평 화면에서 상품평 등록시 호출됩니다.\
> \* 상품번호를 파라미터로 받아서 해당 상품번호에 해당하는 상품평을 등록합니다.\
> \---\
> \## 검증내용\
> \* 0000 : 상품평이 성공적으로 등록된 경우입니다.\
> \* 5002 : request에 회원번호가 없는 경우 발생합니다. 로그아웃 상태에서 상품평 등록 요청시 발생하는 에러입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 상품평 작성 여부 수정 API 호출시 필수값 세팅 오류 수정
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReviewBase":{"type":"object","description":"상품리뷰 기본정보 DTO","properties":{"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"revCont":{"type":"string","description":"리뷰내용"},"revScrVal":{"type":"number","format":"float","description":"리뷰별점"},"stfd1Yn":{"type":"string","description":"만족도1여부(배송)"},"stfd2Yn":{"type":"string","description":"만족도2여부(응대)"},"stfd3Yn":{"type":"string","description":"만족도3여부"},"contents":{"type":"array","description":"리뷰콘텐츠목록","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"상품리뷰평가","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"상품리뷰 콘텐츠 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"콘텐츠파일경로"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"전시순서"},"contentCnt":{"type":"integer","format":"int64","description":"리뷰콘텐츠수"},"status":{"type":"string","description":"콘텐츠 상태 C: 등록, U: 수정, D: 삭제"},"fileContentsYn":{"type":"string","description":"파일 포함 여부 (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"상품리뷰 평가 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltVal":{"type":"string","description":"평가값명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"repValueYn":{"type":"string","description":"대표평가값"},"evltValPrcnt":{"type":"integer","format":"int64","description":"평가백분율"}}},"ResponseVoid":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/goods/{goodsNo}":{"post":{"tags":["상품 리뷰 관리"],"summary":"상품리뷰 등록","description":"## 기능설명\n* 상품평을 등록하는 API 입니다.\n---\n## 상세설명\n* 회원이 구매한 상품의 상품평을 등록합니다.\n* 마이페이지의 작성 가능 상품평 화면에서 상품평 등록시 호출됩니다.\n* 상품번호를 파라미터로 받아서 해당 상품번호에 해당하는 상품평을 등록합니다.\n---\n## 검증내용\n* 0000 : 상품평이 성공적으로 등록된 경우입니다.\n* 5002 : request에 회원번호가 없는 경우 발생합니다. 로그아웃 상태에서 상품평 등록 요청시 발생하는 에러입니다.\n---\n## 수정번호\n* Release v2.00_240425: 상품평 작성 여부 수정 API 호출시 필수값 세팅 오류 수정\n","operationId":"createReview","parameters":[{"name":"goodsNo","in":"path","required":true,"schema":{"type":"string"}},{"name":"files","in":"query","description":"멀티미디어 정보","schema":{"type":"string","format":"binary"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"description":"등록 리뷰 정보","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}},"required":true},"responses":{"200":{"description":"상품평 등록 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"상품평 등록 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품평 신고
> \## 기능설명\
> \* 상품평을 신고 API입니다.\
> \---\
> \## 상세설명\
> \* 리뷰번호, 리뷰신고유형코드를 필수 파라미터로 받아 상품평을 신고합니다.\
> \* 리뷰신고유형이 기타일 경우 리뷰신고기타사유가 필수 파라미터로 필요합니다.\
> \* 본인이 작성하지 않은 상품평만 신고할 수 있습니다.\
> \---\
> \## 검증내용\
> \* 0000 : 상품평을 성공적으로 신고한 경우입니다.\
> \* 5000 : 리뷰신고유형코드 누락 / 기타(90)유형인데 신고기타사유 누락 시 발생하는 에러입니다.\
> \* 5002 : 회원 정보가 없는 상태에서 상품평 신고시 발생합니다. 로그아웃 상태에서 상품평 신고 요청시 발생하는 에러입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReviewDeclaration":{"type":"object","description":"상품리뷰신고 DTO","properties":{"revDclTypCd":{"type":"string","description":"리뷰신고유형코드(PR067)"},"revDclEtcCaus":{"type":"string","description":"리뷰신고기타사유"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/declaration/{revNo}":{"post":{"tags":["상품 리뷰 관리"],"summary":"상품평 신고","description":"## 기능설명\n* 상품평을 신고 API입니다.\n---\n## 상세설명\n* 리뷰번호, 리뷰신고유형코드를 필수 파라미터로 받아 상품평을 신고합니다.\n* 리뷰신고유형이 기타일 경우 리뷰신고기타사유가 필수 파라미터로 필요합니다.\n* 본인이 작성하지 않은 상품평만 신고할 수 있습니다.\n---\n## 검증내용\n* 0000 : 상품평을 성공적으로 신고한 경우입니다.\n* 5000 : 리뷰신고유형코드 누락 / 기타(90)유형인데 신고기타사유 누락 시 발생하는 에러입니다.\n* 5002 : 회원 정보가 없는 상태에서 상품평 신고시 발생합니다. 로그아웃 상태에서 상품평 신고 요청시 발생하는 에러입니다.\n","operationId":"insertReviewDeclaration","parameters":[{"name":"declaration","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsReviewDeclaration"}},{"name":"revNo","in":"path","description":"리뷰번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품평 신고 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}},"900":{"description":"상품평 신고 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품리뷰 단건 조회 (상품정보 포함)
> \## 기능설명\
> \* 상품리뷰 단건 정보와 상품정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품번호를 파라미터로 받아 상품리뷰 상세 정보와 상품정보를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsReview":{"type":"object","description":"상품 리뷰 DTO","properties":{"goods":{"$ref":"#/components/schemas/GoodsBase","description":"상품정보"},"review":{"$ref":"#/components/schemas/GoodsReviewBase","description":"리뷰정보"},"reviewListData":{"$ref":"#/components/schemas/GoodsReviewListDataGoodsReviewBase","description":"리뷰목록정보"}}},"GoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"brandNm":{"type":"string","description":"브랜드명"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"GoodsReviewBase":{"type":"object","description":"상품리뷰 기본정보 DTO","properties":{"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"revCont":{"type":"string","description":"리뷰내용"},"revScrVal":{"type":"number","format":"float","description":"리뷰별점"},"stfd1Yn":{"type":"string","description":"만족도1여부(배송)"},"stfd2Yn":{"type":"string","description":"만족도2여부(응대)"},"stfd3Yn":{"type":"string","description":"만족도3여부"},"contents":{"type":"array","description":"리뷰콘텐츠목록","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"상품리뷰평가","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"상품리뷰 콘텐츠 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"콘텐츠파일경로"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"전시순서"},"contentCnt":{"type":"integer","format":"int64","description":"리뷰콘텐츠수"},"status":{"type":"string","description":"콘텐츠 상태 C: 등록, U: 수정, D: 삭제"},"fileContentsYn":{"type":"string","description":"파일 포함 여부 (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"상품리뷰 평가 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltVal":{"type":"string","description":"평가값명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"repValueYn":{"type":"string","description":"대표평가값"},"evltValPrcnt":{"type":"integer","format":"int64","description":"평가백분율"}}},"GoodsReviewListDataGoodsReviewBase":{"type":"object","description":"상품리뷰 목록 DTO","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsReviewBase"}},"totalCnt":{"type":"integer","format":"int64"},"textRevCnt":{"type":"integer","format":"int64","description":"텍스트 리뷰 개수"},"photoVideoRevCnt":{"type":"integer","format":"int64","description":"포토/동영상 리뷰 개수"}}}}},"paths":{"/v1/review/adv/{revNo}/goods":{"get":{"tags":["상품 리뷰 관리"],"summary":"상품리뷰 단건 조회 (상품정보 포함)","description":"## 기능설명\n* 상품리뷰 단건 정보와 상품정보를 조회합니다.\n---\n## 상세설명\n* 상품번호를 파라미터로 받아 상품리뷰 상세 정보와 상품정보를 조회합니다.\n","operationId":"getReviewAndGoodsInfo","parameters":[{"name":"revNo","in":"path","description":"리뷰번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품평 정보 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}},"900":{"description":"상품평 정보 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}}}}}}}
```
## 회원별 상품평 목록 조회
> \## 기능설명\
> \* 회원이 작성한 상품평 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 회원이 작성한 상품평 목록을 조회합니다.\
> \* 별도 조회조건 미설정시 최근 1개월 내 작성된 상품평 목록을 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductReviewPublicList":{"type":"object","description":"상품평 목록 정보","properties":{"revAllList":{"type":"array","description":"리뷰 목록","items":{"$ref":"#/components/schemas/ProductReview"}},"revAllListTotalCnt":{"type":"integer","format":"int32","description":"총 리뷰 갯수"}}},"ProductReview":{"type":"object","description":"상품평 정보","properties":{"revNo":{"type":"string","description":"리뷰번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원아이디"},"goodsNo":{"type":"string","description":"상품번호"},"goodsImgPathNm":{"type":"string","description":"상품 대표이미지"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"string","description":"주문순번"},"revTypCd":{"type":"string","description":"리뷰유형코드(PR036)"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"revWrtDtm":{"type":"string","format":"date-time","description":"리뷰작성일시"},"revCont":{"type":"string","description":"리뷰내용"},"revScrVal":{"type":"number","format":"float","description":"리뷰별점"},"stfd1Yn":{"type":"string","description":"만족도1여부(배송)"},"stfd2Yn":{"type":"string","description":"만족도2여부(응대)"},"stfd3Yn":{"type":"string","description":"만족도3여부"},"buyMembYn":{"type":"string","description":"구매회원여부"},"revDispStatCd":{"type":"string","description":"리뷰전시상태코드(PR022)"},"contDispStatCd":{"type":"string","description":"컨텐츠전시상태코드(PR022)"},"dispProcDtm":{"type":"string","format":"date-time","description":"전시처리일시"},"dispProcmnId":{"type":"string","description":"전시처리자ID"},"hlpfulCnt":{"type":"string","description":"도움돼요수"},"contentCnt":{"type":"string","description":"리뷰의 컨텐츠(이미지, 동영상) 수"},"contRevGbCd":{"type":"string"},"contFilePathNm":{"type":"string","description":"대표 컨텐츠 url"},"myClickedHelpYn":{"type":"string","description":"본인 도움돼요 클릭여부"},"mbrGradeNm":{"type":"string","description":"회원등급명(ME008)"},"brandNm":{"type":"string","description":"브랜드명"},"goodsNm":{"type":"string","description":"상품평"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"sysModDtm":{"type":"string","format":"date-time","description":"수정일시"},"myReviewYn":{"type":"string","description":"본인작성여부"},"totalListCnt":{"type":"integer","format":"int32","description":"전체 갯수"},"adlCertiYn":{"type":"string","description":"성인인증여부"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"revContList":{"type":"array","description":"리뷰 컨텐츠 리스트","items":{"$ref":"#/components/schemas/ProductReviewContent"}},"revEvltList":{"type":"array","description":"리뷰 평가 리스트","items":{"$ref":"#/components/schemas/ProductReviewEvlt"}},"revPrfleList":{"type":"array","description":"리뷰 프로필 리스트","items":{"$ref":"#/components/schemas/ProductReviewPrfle"}},"revMileageDto":{"$ref":"#/components/schemas/RevMileageDto","description":"마일리지 정보"},"productReviewOrderGoods":{"$ref":"#/components/schemas/ProductReviewOrderGoods","description":"주문상품정보"}}},"ProductReviewContent":{"type":"object","description":"상품평 정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"revNo":{"type":"string","description":"리뷰번호"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"contentCnt":{"type":"string","description":"리뷰 컨텐츠 수"},"newCmtSerialNo":{"type":"string","description":"신규컨텐츠일련번호"},"transStatCd":{"type":"string","description":"동영상변환여부코드"},"thumbUrl":{"type":"string","description":"썸네일 url"},"orgPathNm":{"type":"string","description":"원본경로명"},"sysModId":{"type":"string","description":"수정자ID"},"productReview":{"description":"상품리뷰정보"},"productReviewContent":{"description":"상품평 정보","writeOnly":true}}},"ProductReviewEvlt":{"type":"object","description":"상품평 평가 정보","properties":{"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltValNm":{"type":"string","description":"평가값명"},"evltValPrcnt":{"type":"string","description":"평가항목 비율"},"mdtyEvltItemYn":{"type":"string","description":"필수평가항목여부"},"revNo":{"type":"string","description":"리뷰번호"}}},"ProductReviewPrfle":{"type":"object","description":"상품평 회원 프로필 정보","properties":{"revNo":{"type":"string","description":"리뷰번호"},"mbrPrfleCd":{"type":"string","description":"회원프로필코드(ME010)"},"mbrPrfleNm":{"type":"string","description":"회원프로필명"},"mbrPrfleValNo":{"type":"string","description":"회원프로필값번호"},"mbrPrfleValNm":{"type":"string","description":"회원프로필값명"},"ansCont":{"type":"string","description":"답변내용"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"}}},"RevMileageDto":{"type":"object","description":"상품평 마일리지 DTO","properties":{"mbrNo":{"type":"string","description":"회원번호"},"revNo":{"type":"string","description":"리뷰번호"},"rsrvYn":{"type":"string","description":"마일리지 적립여부"},"hlpRsrvMilg":{"type":"integer","format":"int32","description":"도움돼요 마일리지"},"astGbCd":{"type":"string","description":"자산구분코드(ME015)"},"rsrvUseGbCd":{"type":"string","description":"적립사용구분코드(ME016)"},"astRsrvUseCausCd":{"type":"string","description":"자산적립사용사유코드(ME020)"},"rsrvGbCd":{"type":"string","description":"적립구분코드(CM016)"},"rsrvTgtCd":{"type":"string","description":"적립대상코드(CM017)"},"ocurMlg":{"type":"integer","format":"int64","description":"마일리지 사용/적립 발생 금액"},"astMgrNo":{"type":"string","description":"자산관리번호"},"astMgrDtlNo":{"type":"string","description":"자산관리상세번호"},"orgAstMgrDtlNo":{"type":"string","description":"원주문 결제번호"},"rsrvDtlConts":{"type":"string","description":"마일리지 적립 상세내용"}}},"ProductReviewOrderGoods":{"type":"object","description":"주문상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"brandNm":{"type":"string","description":"브랜드명"},"imgUrl":{"type":"string","description":"이미지 url"},"shopCd":{"type":"string","description":"매장코드","writeOnly":true},"shopNm":{"type":"string","description":"매장명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/member":{"get":{"tags":["상품 리뷰 관리"],"summary":"회원별 상품평 목록 조회","description":"## 기능설명\n* 회원이 작성한 상품평 목록을 조회합니다.\n---\n## 상세설명\n* 회원이 작성한 상품평 목록을 조회합니다.\n* 별도 조회조건 미설정시 최근 1개월 내 작성된 상품평 목록을 조회합니다.\n","operationId":"getMemberReviewList","parameters":[{"name":"searchStartDate","in":"query","description":"조회시작일","schema":{"type":"string","description":"localDateTime"}},{"name":"searchEndDate","in":"query","description":"조회종료일","schema":{"type":"string","description":"localDateTime"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"회원별 상품평정보 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductReviewPublicList"}}}},"900":{"description":"회원별 상품평정보 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 회원별 상품평 총 개수 조회
> \## 기능설명\
> \* 회원이 작성한 상품평 총 개수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 회원이 작성한 상품평 총 개수를 조회합니다.\
> \* 삭제되지 않은 모든 상품평 개수를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/review/adv/member/count":{"get":{"tags":["상품 리뷰 관리"],"summary":"회원별 상품평 총 개수 조회","description":"## 기능설명\n* 회원이 작성한 상품평 총 개수를 조회합니다.\n---\n## 상세설명\n* 회원이 작성한 상품평 총 개수를 조회합니다.\n* 삭제되지 않은 모든 상품평 개수를 조회합니다.\n","operationId":"getReviewCount","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"integer","format":"int64"}}}}}}}}}
```
## 상품별 상품평 요약정보 조회
> \## 기능설명\
> \* 상품평 총 개수, 평점, 평가통계, 평가통계 디테일을 조회합니다.\
> \---\
> \## 상세설명\
> \* 해당 상품의 총 상품평 개수, 평점, 평가통계, 평가통계 디테일을 조회합니다.\
> \* 상품상세 화면 하단 상품평 정보 영역에 해당 상품의 상품평 토탈 정보 노출을 위해 호출됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RevTotalDto":{"type":"object","description":"상품평 토탈정보 DTO","properties":{"goodsRevSummary":{"$ref":"#/components/schemas/RevSummaryDto","description":"리뷰요약정보"},"revEvltListOfTopPcent":{"type":"array","description":"전체리뷰 최고통계","items":{"$ref":"#/components/schemas/RevEvltDto"}},"revAllEvltList":{"type":"array","description":"전체리뷰 평가통계 정보","items":{"$ref":"#/components/schemas/RevEvltDto"}}}},"RevSummaryDto":{"type":"object","description":"상품평 요약 정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"totScr":{"type":"number","format":"double","description":"전체점수"},"avgScr":{"type":"number","format":"double","description":"평균점수"},"revTotCnt":{"type":"integer","format":"int64","description":"리뷰전체갯수"},"totalRevCnt":{"type":"string","description":"전체 리뷰 갯수"},"photoVideoRevCnt":{"type":"string","description":"포토/동영상 리뷰 갯수"},"normalRevCnt":{"type":"string","description":"일반리뷰 갯수"}}},"RevEvltDto":{"type":"object","description":"상품평 평가 DTO","properties":{"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"evltValNo":{"type":"string","description":"평가값번호"},"evltValNm":{"type":"string","description":"평가값명"},"evltValPrcnt":{"type":"string","description":"평가항목 비율"},"mdtyEvltItemYn":{"type":"string","description":"필수평가항목여부"},"revNo":{"type":"string","description":"리뷰번호"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/goods/{goodsNo}/summary":{"get":{"tags":["상품 리뷰 관리"],"summary":"상품별 상품평 요약정보 조회","description":"## 기능설명\n* 상품평 총 개수, 평점, 평가통계, 평가통계 디테일을 조회합니다.\n---\n## 상세설명\n* 해당 상품의 총 상품평 개수, 평점, 평가통계, 평가통계 디테일을 조회합니다.\n* 상품상세 화면 하단 상품평 정보 영역에 해당 상품의 상품평 토탈 정보 노출을 위해 호출됩니다.\n","operationId":"getReviewSummary","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품별 상품평 토탈정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RevTotalDto"}}}},"900":{"description":"상품별 상품평 토탈정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품평 사진/동영상 썸네일 조회
> \## 기능설명\
> \* 상품평의 사진/동영상 썸네일을 조회합니다.\
> \---\
> \## 상세설명\
> \* 최근 작성된 사진/동영상 첨부 상품평의 썸네일을 조회합니다.\
> \* 상품상세 화면 하단 상품평 정보 영역과, 상품별 상품평 목록 화면 상단에 사진/동영상 상품평의 썸네일을 노출하기 위해 호출합니다.\
> \* 각 상품평 별로 1개의 썸네일이 조회되며, 총 개수가 4개가 넘을 경우 더보기 버튼이 호출됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CommonListDataGoodsReviewContent":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"totalCnt":{"type":"integer","format":"int64"}}},"GoodsReviewContent":{"type":"object","description":"상품리뷰 콘텐츠 DTO","properties":{"revNo":{"type":"string","description":"리뷰번호"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"contFilePathNm":{"type":"string","description":"콘텐츠파일경로"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"revGbCd":{"type":"string","description":"리뷰구분코드(PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"전시순서"},"contentCnt":{"type":"integer","format":"int64","description":"리뷰콘텐츠수"},"status":{"type":"string","description":"콘텐츠 상태 C: 등록, U: 수정, D: 삭제"},"fileContentsYn":{"type":"string","description":"파일 포함 여부 (Y/N)"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/goods/{goodsNo}/represent/thumbnails":{"get":{"tags":["상품 리뷰 관리"],"summary":"상품평 사진/동영상 썸네일 조회","description":"## 기능설명\n* 상품평의 사진/동영상 썸네일을 조회합니다.\n---\n## 상세설명\n* 최근 작성된 사진/동영상 첨부 상품평의 썸네일을 조회합니다.\n* 상품상세 화면 하단 상품평 정보 영역과, 상품별 상품평 목록 화면 상단에 사진/동영상 상품평의 썸네일을 노출하기 위해 호출합니다.\n* 각 상품평 별로 1개의 썸네일이 조회되며, 총 개수가 4개가 넘을 경우 더보기 버튼이 호출됩니다.\n","operationId":"getReviewRepresentThumbnailList","parameters":[{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"string"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품 사진/동영상 썸네일 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonListDataGoodsReviewContent"}}}},"900":{"description":"상품 사진/동영상 썸네일 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품번호별 평가정보리스트 조회
> \## 기능설명\
> \* 상품번호를 통해 카테고리별 평가정보리스트를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품번호를 통해 표준카테고리번호를 조회합니다.\
> \* 조회된 표준카테고리번호에 매핑된 표준카테고리별 평가정보리스트를 조회합니다.\
> \* 상품평 등록 화면에서 해당 상품과 매핑된 표준카테고리와 평가항목을 나타내기 위해 호출됩니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v2.00\_240401\`\`\`: 평가정보리스트를 표준카테고리별 조회에서 상품번호별 조회로 변경
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EvaluationItem":{"type":"object","properties":{"evltItemNo":{"type":"string","description":"평가항목번호"},"evltItemNm":{"type":"string","description":"평가항목명"},"useYn":{"type":"string","description":"사용여부"},"valueList":{"type":"array","description":"평가값 목록","items":{"$ref":"#/components/schemas/EvaluationValue"}}}},"EvaluationValue":{"type":"object","properties":{"evltItemNo":{"type":"string","description":"평가항목번호"},"evltValNo":{"type":"string","description":"평가값번호"},"evltVal":{"type":"string","description":"평가값명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"selectedYn":{"type":"string","description":"선택여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/review/adv/evaluations/{goodsNo}":{"get":{"tags":["상품 리뷰 관리"],"summary":"상품번호별 평가정보리스트 조회","description":"## 기능설명\n* 상품번호를 통해 카테고리별 평가정보리스트를 조회합니다.\n---\n## 상세설명\n* 상품번호를 통해 표준카테고리번호를 조회합니다.\n* 조회된 표준카테고리번호에 매핑된 표준카테고리별 평가정보리스트를 조회합니다.\n* 상품평 등록 화면에서 해당 상품과 매핑된 표준카테고리와 평가항목을 나타내기 위해 호출됩니다.\n---\n## 수정번호\n```Release v2.00_240401```: 평가정보리스트를 표준카테고리별 조회에서 상품번호별 조회로 변경\n","operationId":"getEvaluationList","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string"}},{"name":"revNo","in":"query","description":"리뷰번호","schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"카테고리별 평가정보리스트 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationItem"}}}}},"900":{"description":"카테고리별 평가정보리스트 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/goods-api/undefined.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.