> 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/api-en/store-front-api-reference/goods-api/product-review-management.md).
# Product Review Management
## Retrieve Single Product Review
> \## Function Description\
> \* Retrieves a single product review record.\
> \---\
> \## Detailed Description\
> \* Retrieves the detailed information of a product review using the product number as a parameter.
```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":"Product Review Basic Info DTO","properties":{"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"revCont":{"type":"string","description":"Review Content"},"revScrVal":{"type":"number","format":"float","description":"Review Rating"},"stfd1Yn":{"type":"string","description":"Satisfaction 1 Status (Delivery)"},"stfd2Yn":{"type":"string","description":"Satisfaction 2 Status (Response)"},"stfd3Yn":{"type":"string","description":"Satisfaction Level 3 Status"},"contents":{"type":"array","description":"Review Content List","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"Product Review Rating","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"Product Review Content DTO","properties":{"revNo":{"type":"string","description":"Review No."},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"Display Order"},"contentCnt":{"type":"integer","format":"int64","description":"Review Content Count"},"status":{"type":"string","description":"Content Status C: Created, U: Modified, D: Deleted"},"fileContentsYn":{"type":"string","description":"File Included Status (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"Product Review Rating DTO","properties":{"revNo":{"type":"string","description":"Review No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltVal":{"type":"string","description":"Evaluation Value Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"repValueYn":{"type":"string","description":"Representative Rating Value"},"evltValPrcnt":{"type":"integer","format":"int64","description":"Rating Percentage"}}}}},"paths":{"/v1/review/adv/{revNo}":{"get":{"tags":["Product Review Management"],"summary":"Retrieve Single Product Review","description":"## Function Description\n* Retrieves a single product review record.\n---\n## Detailed Description\n* Retrieves the detailed information of a product review using the product number as a parameter.\n","operationId":"getReview","parameters":[{"name":"revNo","in":"path","description":"Review No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Product Review Information Retrieved Successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}}},"900":{"description":"Product Review Information Retrieval Failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}}}}}}}}
```
## Modify Product Review
> \## Function Description\
> \* This API modifies a product review.\
> \---\
> \## Detailed Description\
> \* Modifies a review previously written by the member.\
> \* Called when a review is edited on the My Reviews screen in My Page.\
> \* Modifies the review corresponding to the given review number, which is received as a parameter.\
> \* Verifies the member information so that only the member who wrote the review can modify it.\
> \---\
> \## Validation Details\
> \* 0000 : The review was successfully modified.\
> \* 5002 : Occurs when the member number is missing from the request. This error occurs when a review modification request is made while logged out.\
> \---\
> \## Revision History\
> \* Release v2.00\_240425: Fixed an error in required-value setting when calling the API to modify the review-written status
```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":"Product Review Basic Info DTO","properties":{"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"revCont":{"type":"string","description":"Review Content"},"revScrVal":{"type":"number","format":"float","description":"Review Rating"},"stfd1Yn":{"type":"string","description":"Satisfaction 1 Status (Delivery)"},"stfd2Yn":{"type":"string","description":"Satisfaction 2 Status (Response)"},"stfd3Yn":{"type":"string","description":"Satisfaction Level 3 Status"},"contents":{"type":"array","description":"Review Content List","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"Product Review Rating","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"Product Review Content DTO","properties":{"revNo":{"type":"string","description":"Review No."},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"Display Order"},"contentCnt":{"type":"integer","format":"int64","description":"Review Content Count"},"status":{"type":"string","description":"Content Status C: Created, U: Modified, D: Deleted"},"fileContentsYn":{"type":"string","description":"File Included Status (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"Product Review Rating DTO","properties":{"revNo":{"type":"string","description":"Review No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltVal":{"type":"string","description":"Evaluation Value Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"repValueYn":{"type":"string","description":"Representative Rating Value"},"evltValPrcnt":{"type":"integer","format":"int64","description":"Rating Percentage"}}},"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":["Product Review Management"],"summary":"Modify Product Review","description":"## Function Description\n* This API modifies a product review.\n---\n## Detailed Description\n* Modifies a review previously written by the member.\n* Called when a review is edited on the My Reviews screen in My Page.\n* Modifies the review corresponding to the given review number, which is received as a parameter.\n* Verifies the member information so that only the member who wrote the review can modify it.\n---\n## Validation Details\n* 0000 : The review was successfully modified.\n* 5002 : Occurs when the member number is missing from the request. This error occurs when a review modification request is made while logged out.\n---\n## Revision History\n* Release v2.00_240425: Fixed an error in required-value setting when calling the API to modify the review-written status\n","operationId":"modifyReview","parameters":[{"name":"revNo","in":"path","description":"Review No.","required":true,"schema":{"type":"string"}},{"name":"files","in":"query","description":"Multimedia Information","schema":{"type":"string","format":"binary"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"description":"Registered Review Information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}},"required":true},"responses":{"200":{"description":"Review Modification Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"Review Modification Failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Delete Review
> \## Function Description\
> \* This API deletes a product review.\
> \---\
> \## Detailed Description\
> \* Called when a review is deleted on the My Reviews screen in My Page.\
> \* Verifies the member information so that only the member who wrote the review can delete it.\
> \* Does not physically delete the review; instead, it changes the deletion status to 'Y' so that it is hidden from the screen.\
> \---\
> \## Validation Details\
> \* 0000 : The review was successfully deleted.\
> \* 5000 : Occurs when member information is missing. This error occurs when a review report request is made while logged out.
```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":["Product Review Management"],"summary":"Delete Review","description":"## Function Description\n* This API deletes a product review.\n---\n## Detailed Description\n* Called when a review is deleted on the My Reviews screen in My Page.\n* Verifies the member information so that only the member who wrote the review can delete it.\n* Does not physically delete the review; instead, it changes the deletion status to 'Y' so that it is hidden from the screen.\n---\n## Validation Details\n* 0000 : The review was successfully deleted.\n* 5000 : Occurs when member information is missing. This error occurs when a review report request is made while logged out.\n","operationId":"deleteReview","parameters":[{"name":"revNo","in":"path","description":"Review No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Review Deletion Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}},"900":{"description":"Review Deletion Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Update Review Helpful Count and Retrieve Total Count
> \## Function Description\
> \* Updates the Helpful count of a review and retrieves the total Helpful count for that review.\
> \---\
> \## Detailed Description\
> \* Updates the Helpful count of a review and retrieves the total Helpful count for that review.\
> \* Verifies the review's member information so that Helpful can only be marked on reviews not written by the member themselves.
```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":"Product Review Helpful DTO","properties":{"revNo":{"type":"string","description":"Review No."},"mbrNo":{"type":"string","description":"Member No."},"delYn":{"type":"string","description":"Deletion Status"},"hlpfulCnt":{"type":"integer","format":"int32","description":"Helpful Count"}}}}},"paths":{"/v1/review/adv/helpful/{revNo}":{"post":{"tags":["Product Review Management"],"summary":"Update Review Helpful Count and Retrieve Total Count","description":"## Function Description\n* Updates the Helpful count of a review and retrieves the total Helpful count for that review.\n---\n## Detailed Description\n* Updates the Helpful count of a review and retrieves the total Helpful count for that review.\n* Verifies the review's member information so that Helpful can only be marked on reviews not written by the member themselves.\n","operationId":"updateAndGetReviewHelpful","parameters":[{"name":"revNo","in":"path","description":"Review No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GoodsReviewHelpful"}}}}}}}}}
```
## Retrieve Review Info by Product
> \## Function Description\
> \* Retrieves the list of reviews for a product.\
> \---\
> \## Detailed Description\
> \* Retrieves the product's review list using the product number as a parameter.\
> \* Called to display review information in the review section at the bottom of the product detail page.\
> \* When retrieving the classified review count, if the review classification code list exists, the classified review count is not retrieved.\
> \---\
> \## Code Reference\
> \* \`\`\` Sort Type Code \`\`\` : latest: Latest, recommend: Recommended
````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":"Product Review DTO","properties":{"goods":{"$ref":"#/components/schemas/GoodsBase","description":"Product Information"},"review":{"$ref":"#/components/schemas/GoodsReviewBase","description":"Review Info"},"reviewListData":{"$ref":"#/components/schemas/GoodsReviewListDataGoodsReviewBase","description":"Review List Info"}}},"GoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"contFilePathNm":{"type":"string","description":"Content File Path"},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."}}},"GoodsReviewBase":{"type":"object","description":"Product Review Basic Info DTO","properties":{"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"revCont":{"type":"string","description":"Review Content"},"revScrVal":{"type":"number","format":"float","description":"Review Rating"},"stfd1Yn":{"type":"string","description":"Satisfaction 1 Status (Delivery)"},"stfd2Yn":{"type":"string","description":"Satisfaction 2 Status (Response)"},"stfd3Yn":{"type":"string","description":"Satisfaction Level 3 Status"},"contents":{"type":"array","description":"Review Content List","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"Product Review Rating","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"Product Review Content DTO","properties":{"revNo":{"type":"string","description":"Review No."},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"Display Order"},"contentCnt":{"type":"integer","format":"int64","description":"Review Content Count"},"status":{"type":"string","description":"Content Status C: Created, U: Modified, D: Deleted"},"fileContentsYn":{"type":"string","description":"File Included Status (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"Product Review Rating DTO","properties":{"revNo":{"type":"string","description":"Review No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltVal":{"type":"string","description":"Evaluation Value Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"repValueYn":{"type":"string","description":"Representative Rating Value"},"evltValPrcnt":{"type":"integer","format":"int64","description":"Rating Percentage"}}},"GoodsReviewListDataGoodsReviewBase":{"type":"object","description":"Product Review List DTO","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsReviewBase"}},"totalCnt":{"type":"integer","format":"int64"},"textRevCnt":{"type":"integer","format":"int64","description":"Text Review Count"},"photoVideoRevCnt":{"type":"integer","format":"int64","description":"Photo/Video Review Count"}}}}},"paths":{"/v1/review/adv/goods/{goodsNo}":{"get":{"tags":["Product Review Management"],"summary":"Retrieve Review Info by Product","description":"## Function Description\n* Retrieves the list of reviews for a product.\n---\n## Detailed Description\n* Retrieves the product's review list using the product number as a parameter.\n* Called to display review information in the review section at the bottom of the product detail page.\n* When retrieving the classified review count, if the review classification code list exists, the classified review count is not retrieved.\n---\n## Code Reference\n* ``` Sort Type Code ``` : latest: Latest, recommend: Recommended\n","operationId":"getGoodsInfoAndReviewList","parameters":[{"name":"goodsNo","in":"path","description":"Product No.","required":true,"schema":{"type":"string"}},{"name":"revGbCdList","in":"query","description":"Review Classification Code List","schema":{"type":"array"}},{"name":"sortTypeCd","in":"query","description":"Sort Type Code","schema":{"type":"string"}},{"name":"typeCountYn","in":"query","description":"Classified Review Count Status","schema":{"type":"string"}},{"name":"pageNo","in":"query","description":"Requested Page No.","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"Requested Page Size","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Review Info by Product Inquiry Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}},"900":{"description":"Review Info by Product Inquiry Failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}}}}}}}
````
## Register Product Review
> \## Function Description\
> \* This API registers a product review.\
> \---\
> \## Detailed Description\
> \* Registers a review for a product purchased by the member.\
> \* Called when a review is registered on the Writable Reviews screen in My Page.\
> \* Registers the review corresponding to the given product number, which is received as a parameter.\
> \---\
> \## Validation Details\
> \* 0000 : The review was successfully registered.\
> \* 5002 : Occurs when the member number is missing from the request. This error occurs when a review registration request is made while logged out.\
> \---\
> \## Revision History\
> \* Release v2.00\_240425: Fixed an error in required-value setting when calling the API to modify the review-written status
```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":"Product Review Basic Info DTO","properties":{"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"revCont":{"type":"string","description":"Review Content"},"revScrVal":{"type":"number","format":"float","description":"Review Rating"},"stfd1Yn":{"type":"string","description":"Satisfaction 1 Status (Delivery)"},"stfd2Yn":{"type":"string","description":"Satisfaction 2 Status (Response)"},"stfd3Yn":{"type":"string","description":"Satisfaction Level 3 Status"},"contents":{"type":"array","description":"Review Content List","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"Product Review Rating","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"Product Review Content DTO","properties":{"revNo":{"type":"string","description":"Review No."},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"Display Order"},"contentCnt":{"type":"integer","format":"int64","description":"Review Content Count"},"status":{"type":"string","description":"Content Status C: Created, U: Modified, D: Deleted"},"fileContentsYn":{"type":"string","description":"File Included Status (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"Product Review Rating DTO","properties":{"revNo":{"type":"string","description":"Review No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltVal":{"type":"string","description":"Evaluation Value Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"repValueYn":{"type":"string","description":"Representative Rating Value"},"evltValPrcnt":{"type":"integer","format":"int64","description":"Rating Percentage"}}},"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":["Product Review Management"],"summary":"Register Product Review","description":"## Function Description\n* This API registers a product review.\n---\n## Detailed Description\n* Registers a review for a product purchased by the member.\n* Called when a review is registered on the Writable Reviews screen in My Page.\n* Registers the review corresponding to the given product number, which is received as a parameter.\n---\n## Validation Details\n* 0000 : The review was successfully registered.\n* 5002 : Occurs when the member number is missing from the request. This error occurs when a review registration request is made while logged out.\n---\n## Revision History\n* Release v2.00_240425: Fixed an error in required-value setting when calling the API to modify the review-written status\n","operationId":"createReview","parameters":[{"name":"goodsNo","in":"path","required":true,"schema":{"type":"string"}},{"name":"files","in":"query","description":"Multimedia Information","schema":{"type":"string","format":"binary"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"description":"Registered Review Information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReviewBase"}}},"required":true},"responses":{"200":{"description":"Review Registration Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"Review Registration Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Report Review
> \## Function Description\
> \* This is the API to report a review.\
> \---\
> \## Detailed Description\
> \* Reports a review using the review number and review report type code as required parameters.\
> \* If the review report type is Other, the other reason for the report is a required parameter.\
> \* Only reviews not written by the member themselves can be reported.\
> \---\
> \## Validation Details\
> \* 0000 : The review was successfully reported.\
> \* 5000 : Occurs when the review report type code is missing, or when the type is Other (90) but the other reason for the report is missing.\
> \* 5002 : Occurs when member information is missing while reporting a review. This error occurs when a review report request is made while logged out.
```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":"Product Review Report DTO","properties":{"revDclTypCd":{"type":"string","description":"Review Report Type Code (PR067)"},"revDclEtcCaus":{"type":"string","description":"Other Review Report Reason"}}},"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":["Product Review Management"],"summary":"Report Review","description":"## Function Description\n* This is the API to report a review.\n---\n## Detailed Description\n* Reports a review using the review number and review report type code as required parameters.\n* If the review report type is Other, the other reason for the report is a required parameter.\n* Only reviews not written by the member themselves can be reported.\n---\n## Validation Details\n* 0000 : The review was successfully reported.\n* 5000 : Occurs when the review report type code is missing, or when the type is Other (90) but the other reason for the report is missing.\n* 5002 : Occurs when member information is missing while reporting a review. This error occurs when a review report request is made while logged out.\n","operationId":"insertReviewDeclaration","parameters":[{"name":"declaration","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsReviewDeclaration"}},{"name":"revNo","in":"path","description":"Review No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Review Report Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}},"900":{"description":"Review Report Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Retrieve Single Product Review (Including Product Info)
> \## Function Description\
> \* Retrieves a single product review record along with product information.\
> \---\
> \## Detailed Description\
> \* Retrieves the detailed review information and product information using the product number as a parameter.
```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":"Product Review DTO","properties":{"goods":{"$ref":"#/components/schemas/GoodsBase","description":"Product Information"},"review":{"$ref":"#/components/schemas/GoodsReviewBase","description":"Review Info"},"reviewListData":{"$ref":"#/components/schemas/GoodsReviewListDataGoodsReviewBase","description":"Review List Info"}}},"GoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"contFilePathNm":{"type":"string","description":"Content File Path"},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."}}},"GoodsReviewBase":{"type":"object","description":"Product Review Basic Info DTO","properties":{"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"revCont":{"type":"string","description":"Review Content"},"revScrVal":{"type":"number","format":"float","description":"Review Rating"},"stfd1Yn":{"type":"string","description":"Satisfaction 1 Status (Delivery)"},"stfd2Yn":{"type":"string","description":"Satisfaction 2 Status (Response)"},"stfd3Yn":{"type":"string","description":"Satisfaction Level 3 Status"},"contents":{"type":"array","description":"Review Content List","items":{"$ref":"#/components/schemas/GoodsReviewContent"}},"evaluations":{"type":"array","description":"Product Review Rating","items":{"$ref":"#/components/schemas/GoodsReviewEvaluation"}}}},"GoodsReviewContent":{"type":"object","description":"Product Review Content DTO","properties":{"revNo":{"type":"string","description":"Review No."},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"Display Order"},"contentCnt":{"type":"integer","format":"int64","description":"Review Content Count"},"status":{"type":"string","description":"Content Status C: Created, U: Modified, D: Deleted"},"fileContentsYn":{"type":"string","description":"File Included Status (Y/N)"}}},"GoodsReviewEvaluation":{"type":"object","description":"Product Review Rating DTO","properties":{"revNo":{"type":"string","description":"Review No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltVal":{"type":"string","description":"Evaluation Value Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"repValueYn":{"type":"string","description":"Representative Rating Value"},"evltValPrcnt":{"type":"integer","format":"int64","description":"Rating Percentage"}}},"GoodsReviewListDataGoodsReviewBase":{"type":"object","description":"Product Review List DTO","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsReviewBase"}},"totalCnt":{"type":"integer","format":"int64"},"textRevCnt":{"type":"integer","format":"int64","description":"Text Review Count"},"photoVideoRevCnt":{"type":"integer","format":"int64","description":"Photo/Video Review Count"}}}}},"paths":{"/v1/review/adv/{revNo}/goods":{"get":{"tags":["Product Review Management"],"summary":"Retrieve Single Product Review (Including Product Info)","description":"## Function Description\n* Retrieves a single product review record along with product information.\n---\n## Detailed Description\n* Retrieves the detailed review information and product information using the product number as a parameter.\n","operationId":"getReviewAndGoodsInfo","parameters":[{"name":"revNo","in":"path","description":"Review No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Product Review Information Retrieved Successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}},"900":{"description":"Product Review Information Retrieval Failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsReview"}}}}}}}}}
```
## Retrieve Review List by Member
> \## Function Description\
> \* Retrieves the list of reviews written by a member.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of reviews written by a member.\
> \* If no separate inquiry condition is set, retrieves the list of reviews written within the last 1 month.
```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":"Review List Info","properties":{"revAllList":{"type":"array","description":"Review List","items":{"$ref":"#/components/schemas/ProductReview"}},"revAllListTotalCnt":{"type":"integer","format":"int32","description":"Total Review Count"}}},"ProductReview":{"type":"object","description":"Product Review Information","properties":{"revNo":{"type":"string","description":"Review No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"goodsNo":{"type":"string","description":"Product No."},"goodsImgPathNm":{"type":"string","description":"Product Main Image"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"ordNo":{"type":"string","description":"Order No."},"ordSeq":{"type":"string","description":"Order Sequence No."},"revTypCd":{"type":"string","description":"Review Type Code (PR036)"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"revWrtDtm":{"type":"string","format":"date-time","description":"Review Creation Date/Time"},"revCont":{"type":"string","description":"Review Content"},"revScrVal":{"type":"number","format":"float","description":"Review Rating"},"stfd1Yn":{"type":"string","description":"Satisfaction 1 Status (Delivery)"},"stfd2Yn":{"type":"string","description":"Satisfaction 2 Status (Response)"},"stfd3Yn":{"type":"string","description":"Satisfaction Level 3 Status"},"buyMembYn":{"type":"string","description":"Purchasing Member Status"},"revDispStatCd":{"type":"string","description":"Review Display Status Code (PR022)"},"contDispStatCd":{"type":"string","description":"Content Display Status Code (PR022)"},"dispProcDtm":{"type":"string","format":"date-time","description":"Display Processing Date/Time"},"dispProcmnId":{"type":"string","description":"Display Processor ID"},"hlpfulCnt":{"type":"string","description":"Helpful Count"},"contentCnt":{"type":"string","description":"Number of Content Items (Images, Videos) in the Review"},"contRevGbCd":{"type":"string"},"contFilePathNm":{"type":"string","description":"Representative Content URL"},"myClickedHelpYn":{"type":"string","description":"Own Helpful Click Status"},"mbrGradeNm":{"type":"string","description":"Member Grade Name (ME008)"},"brandNm":{"type":"string","description":"Brand Name"},"goodsNm":{"type":"string","description":"Review"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"sysModDtm":{"type":"string","format":"date-time","description":"Modification Date/Time"},"myReviewYn":{"type":"string","description":"Self-Written Status"},"totalListCnt":{"type":"integer","format":"int32","description":"Total Count"},"adlCertiYn":{"type":"string","description":"Adult Verification Status"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"revContList":{"type":"array","description":"Review Content List","items":{"$ref":"#/components/schemas/ProductReviewContent"}},"revEvltList":{"type":"array","description":"Review Rating List","items":{"$ref":"#/components/schemas/ProductReviewEvlt"}},"revPrfleList":{"type":"array","description":"Review Profile List","items":{"$ref":"#/components/schemas/ProductReviewPrfle"}},"revMileageDto":{"$ref":"#/components/schemas/RevMileageDto","description":"Mileage Info"},"productReviewOrderGoods":{"$ref":"#/components/schemas/ProductReviewOrderGoods","description":"Order Product Information"}}},"ProductReviewContent":{"type":"object","description":"Product Review Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"revNo":{"type":"string","description":"Review No."},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"contentCnt":{"type":"string","description":"Review Content Count"},"newCmtSerialNo":{"type":"string","description":"New Content Serial No."},"transStatCd":{"type":"string","description":"Video Conversion Status Code"},"thumbUrl":{"type":"string","description":"Thumbnail URL"},"orgPathNm":{"type":"string","description":"Original Path Name"},"sysModId":{"type":"string","description":"Modifier ID"},"productReview":{"description":"Product Review Info"},"productReviewContent":{"description":"Product Review Information","writeOnly":true}}},"ProductReviewEvlt":{"type":"object","description":"Review Rating Info","properties":{"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltValNm":{"type":"string","description":"Evaluation Value Name"},"evltValPrcnt":{"type":"string","description":"Evaluation Item Ratio"},"mdtyEvltItemYn":{"type":"string","description":"Required Evaluation Item Status"},"revNo":{"type":"string","description":"Review No."}}},"ProductReviewPrfle":{"type":"object","description":"Review Member Profile Info","properties":{"revNo":{"type":"string","description":"Review No."},"mbrPrfleCd":{"type":"string","description":"Member Profile Code (ME010)"},"mbrPrfleNm":{"type":"string","description":"Member Profile Name"},"mbrPrfleValNo":{"type":"string","description":"Member Profile Value No."},"mbrPrfleValNm":{"type":"string","description":"Member Profile Value Name"},"ansCont":{"type":"string","description":"Answer Details"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"stdCtgNo":{"type":"string","description":"Standard Classification Category No."}}},"RevMileageDto":{"type":"object","description":"Review Mileage DTO","properties":{"mbrNo":{"type":"string","description":"Member No."},"revNo":{"type":"string","description":"Review No."},"rsrvYn":{"type":"string","description":"Mileage Accrual Status"},"hlpRsrvMilg":{"type":"integer","format":"int32","description":"Helpful Mileage"},"astGbCd":{"type":"string","description":"Asset Type Code (ME015)"},"rsrvUseGbCd":{"type":"string","description":"Accrual/Usage Classification Code (ME016)"},"astRsrvUseCausCd":{"type":"string","description":"Asset Accrual/Usage Reason Code (ME020)"},"rsrvGbCd":{"type":"string","description":"Accrual Classification Code (CM016)"},"rsrvTgtCd":{"type":"string","description":"Accrual Target Code (CM017)"},"ocurMlg":{"type":"integer","format":"int64","description":"Mileage Usage/Accrual Amount"},"astMgrNo":{"type":"string","description":"Asset Management No."},"astMgrDtlNo":{"type":"string","description":"Asset Management Detail No."},"orgAstMgrDtlNo":{"type":"string","description":"Original Order Payment No."},"rsrvDtlConts":{"type":"string","description":"Mileage Accrual Details"}}},"ProductReviewOrderGoods":{"type":"object","description":"Order Product Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"imgUrl":{"type":"string","description":"Image URL"},"shopCd":{"type":"string","description":"Store Code","writeOnly":true},"shopNm":{"type":"string","description":"Store Name"}}},"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":["Product Review Management"],"summary":"Retrieve Review List by Member","description":"## Function Description\n* Retrieves the list of reviews written by a member.\n---\n## Detailed Description\n* Retrieves the list of reviews written by a member.\n* If no separate inquiry condition is set, retrieves the list of reviews written within the last 1 month.\n","operationId":"getMemberReviewList","parameters":[{"name":"searchStartDate","in":"query","description":"Search Start Date","schema":{"type":"string","description":"localDateTime"}},{"name":"searchEndDate","in":"query","description":"Search End Date","schema":{"type":"string","description":"localDateTime"}},{"name":"pageNo","in":"query","description":"Requested Page No.","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"Requested Page Size","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Review Info by Member Inquiry Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductReviewPublicList"}}}},"900":{"description":"Review Info by Member Inquiry Failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Retrieve Total Review Count by Member
> \## Function Description\
> \* Retrieves the total number of reviews written by a member.\
> \---\
> \## Detailed Description\
> \* Retrieves the total number of reviews written by a member.\
> \* Retrieves the count of all reviews that have not been deleted.
```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":["Product Review Management"],"summary":"Retrieve Total Review Count by Member","description":"## Function Description\n* Retrieves the total number of reviews written by a member.\n---\n## Detailed Description\n* Retrieves the total number of reviews written by a member.\n* Retrieves the count of all reviews that have not been deleted.\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"}}}}}}}}}
```
## Retrieve Review Summary Info by Product
> \## Function Description\
> \* Retrieves the total review count, rating, rating statistics, and rating statistics details.\
> \---\
> \## Detailed Description\
> \* Retrieves the total review count, rating, rating statistics, and rating statistics details for the product.\
> \* Called to display the total review information for the product in the review information section at the bottom of the product detail screen.
```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":"Review Total Info DTO","properties":{"goodsRevSummary":{"$ref":"#/components/schemas/RevSummaryDto","description":"Review Summary Info"},"revEvltListOfTopPcent":{"type":"array","description":"Overall Review Top Statistics","items":{"$ref":"#/components/schemas/RevEvltDto"}},"revAllEvltList":{"type":"array","description":"Overall Review Rating Statistics Info","items":{"$ref":"#/components/schemas/RevEvltDto"}}}},"RevSummaryDto":{"type":"object","description":"Review Summary Info","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"totScr":{"type":"number","format":"double","description":"Overall Score"},"avgScr":{"type":"number","format":"double","description":"Average Score"},"revTotCnt":{"type":"integer","format":"int64","description":"Total Review Count"},"totalRevCnt":{"type":"string","description":"Total Review Count"},"photoVideoRevCnt":{"type":"string","description":"Photo/Video Review Count"},"normalRevCnt":{"type":"string","description":"General Review Count"}}},"RevEvltDto":{"type":"object","description":"Review Rating DTO","properties":{"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltValNm":{"type":"string","description":"Evaluation Value Name"},"evltValPrcnt":{"type":"string","description":"Evaluation Item Ratio"},"mdtyEvltItemYn":{"type":"string","description":"Required Evaluation Item Status"},"revNo":{"type":"string","description":"Review No."}}},"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":["Product Review Management"],"summary":"Retrieve Review Summary Info by Product","description":"## Function Description\n* Retrieves the total review count, rating, rating statistics, and rating statistics details.\n---\n## Detailed Description\n* Retrieves the total review count, rating, rating statistics, and rating statistics details for the product.\n* Called to display the total review information for the product in the review information section at the bottom of the product detail screen.\n","operationId":"getReviewSummary","parameters":[{"name":"goodsNo","in":"path","description":"Product No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Total Review Info by Product Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RevTotalDto"}}}},"900":{"description":"Total Review Info by Product Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Retrieve Review Photo/Video Thumbnails
> \## Function Description\
> \* Retrieves photo/video thumbnails from reviews.\
> \---\
> \## Detailed Description\
> \* Retrieves thumbnails from recently written reviews with photo/video attachments.\
> \* Called to display photo/video review thumbnails in the review information section at the bottom of the product detail screen and at the top of the review list screen by product.\
> \* One thumbnail is retrieved per review; if the total count exceeds 4, a View More button is invoked.
```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":"Product Review Content DTO","properties":{"revNo":{"type":"string","description":"Review No."},"contSn":{"type":"string","description":"Content Serial No."},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"revGbCd":{"type":"string","description":"Review Classification Code (PR021)"},"dispSeq":{"type":"integer","format":"int64","description":"Display Order"},"contentCnt":{"type":"integer","format":"int64","description":"Review Content Count"},"status":{"type":"string","description":"Content Status C: Created, U: Modified, D: Deleted"},"fileContentsYn":{"type":"string","description":"File Included Status (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":["Product Review Management"],"summary":"Retrieve Review Photo/Video Thumbnails","description":"## Function Description\n* Retrieves photo/video thumbnails from reviews.\n---\n## Detailed Description\n* Retrieves thumbnails from recently written reviews with photo/video attachments.\n* Called to display photo/video review thumbnails in the review information section at the bottom of the product detail screen and at the top of the review list screen by product.\n* One thumbnail is retrieved per review; if the total count exceeds 4, a View More button is invoked.\n","operationId":"getReviewRepresentThumbnailList","parameters":[{"name":"goodsNo","in":"query","description":"Product No.","required":true,"schema":{"type":"string"}},{"name":"pageNo","in":"query","description":"Requested Page No.","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"Requested Page Size","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Product Photo/Video Thumbnail Inquiry Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonListDataGoodsReviewContent"}}}},"900":{"description":"Product Photo/Video Thumbnail Inquiry Failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## Retrieve Rating Info List by Product No.
> \## Function Description\
> \* Retrieves the rating info list by category using the product number.\
> \---\
> \## Detailed Description\
> \* Retrieves the standard category number using the product number.\
> \* Retrieves the rating info list by standard category mapped to the retrieved standard category number.\
> \* Called on the review registration screen to display the standard category and rating items mapped to the product.\
> \---\
> \## Revision History\
> \`\`\`Release v2.00\_240401\`\`\`: Changed the rating info list from retrieval by standard category to retrieval by product number
````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":"Evaluation Item No."},"evltItemNm":{"type":"string","description":"Evaluation Item Name"},"useYn":{"type":"string","description":"Usage Status"},"valueList":{"type":"array","description":"Rating Value List","items":{"$ref":"#/components/schemas/EvaluationValue"}}}},"EvaluationValue":{"type":"object","properties":{"evltItemNo":{"type":"string","description":"Evaluation Item No."},"evltValNo":{"type":"string","description":"Evaluation Value No."},"evltVal":{"type":"string","description":"Evaluation Value Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"selectedYn":{"type":"string","description":"Selection Status"}}},"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":["Product Review Management"],"summary":"Retrieve Rating Info List by Product No.","description":"## Function Description\n* Retrieves the rating info list by category using the product number.\n---\n## Detailed Description\n* Retrieves the standard category number using the product number.\n* Retrieves the rating info list by standard category mapped to the retrieved standard category number.\n* Called on the review registration screen to display the standard category and rating items mapped to the product.\n---\n## Revision History\n```Release v2.00_240401```: Changed the rating info list from retrieval by standard category to retrieval by product number\n","operationId":"getEvaluationList","parameters":[{"name":"goodsNo","in":"path","description":"Product No.","required":true,"schema":{"type":"string"}},{"name":"revNo","in":"query","description":"Review No.","schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Rating Info List by Category Inquiry Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationItem"}}}}},"900":{"description":"Rating Info List by Category Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````