> 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"}}}}}}}}}
````