> 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/q-and-a.md).
# 상품 Q\&A 관리
## 상품 Q\&A 상세내용 조회
> \## 기능설명\
> \* 상품 Q\&A 상세내용을 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품Q\&A 수정시 기존 상품Q\&A 정보를 불러오기 위해 호출합니다.\
> \* 질문번호를 파라미터로 받아 단일 상품Q\&A의 상세내용을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 상품 Q\&A
````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":{"GoodsQna":{"type":"object","properties":{"goods":{"$ref":"#/components/schemas/GoodsBase"},"question":{"$ref":"#/components/schemas/GoodsQnaQuestion"},"questionListData":{"$ref":"#/components/schemas/CommonListDataGoodsQnaQuestion"},"questionList":{"type":"array","items":{"$ref":"#/components/schemas/GoodsQnaQuestion"}}}},"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":"표준카테고리번호"}}},"GoodsQnaQuestion":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"questDtm":{"type":"string","format":"date-time","description":"질문일시"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"procId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}},"answerList":{"type":"array","description":"답변 목록","items":{"$ref":"#/components/schemas/GoodsQnaAnswer"}},"deleteGoodsQnaContList":{"type":"array","description":"삭제예정 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"GoodsQnaContents":{"type":"object","description":"상품 Q&A 첨부파일 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명","writeOnly":true},"contSn":{"type":"string","description":"컨텐츠일련번호"}}},"GoodsQnaAnswer":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"prodId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"ansCont":{"type":"string","description":"답변내용"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"CommonListDataGoodsQnaQuestion":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsQnaQuestion"}},"totalCnt":{"type":"integer","format":"int64"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/qna/adv/{questNo}":{"get":{"tags":["상품 Q&A 관리"],"summary":"상품 Q&A 상세내용 조회","description":"## 기능설명\n* 상품 Q&A 상세내용을 조회합니다.\n---\n## 상세설명\n* 상품Q&A 수정시 기존 상품Q&A 정보를 불러오기 위해 호출합니다.\n* 질문번호를 파라미터로 받아 단일 상품Q&A의 상세내용을 조회합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 상품 Q&A\n","operationId":"qnaDetail","parameters":[{"name":"questNo","in":"path","description":"질문번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품 Q&A 상세내용 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsQna"}}}},"900":{"description":"상품 Q&A 상세내용 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 상품 Q\&A 수정
> \## 기능설명\
> \* 작성한 상품 Q\&A를 수정합니다.\
> \---\
> \## 상세설명\
> \* 상품 Q\&A 목록 화면 또는 마이페이지의 상품 Q\&A 화면에서 상품 Q\&A 수정시 호출됩니다.\
> \* 질문번호를 파라미터로 받아서 해당 질문번호에 해당하는 상품 Q\&A를 수정합니다.\
> \* 회원정보를 확인하여 본인이 작성한 상품 Q\&A만 수정이 가능합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 상품 Q\&A 수정 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":{"GoodsQnaQuestion":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"questDtm":{"type":"string","format":"date-time","description":"질문일시"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"procId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}},"answerList":{"type":"array","description":"답변 목록","items":{"$ref":"#/components/schemas/GoodsQnaAnswer"}},"deleteGoodsQnaContList":{"type":"array","description":"삭제예정 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"GoodsQnaContents":{"type":"object","description":"상품 Q&A 첨부파일 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명","writeOnly":true},"contSn":{"type":"string","description":"컨텐츠일련번호"}}},"GoodsQnaAnswer":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"prodId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"ansCont":{"type":"string","description":"답변내용"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"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/qna/adv/{questNo}":{"put":{"tags":["상품 Q&A 관리"],"summary":"상품 Q&A 수정","description":"## 기능설명\n* 작성한 상품 Q&A를 수정합니다.\n---\n## 상세설명\n* 상품 Q&A 목록 화면 또는 마이페이지의 상품 Q&A 화면에서 상품 Q&A 수정시 호출됩니다.\n* 질문번호를 파라미터로 받아서 해당 질문번호에 해당하는 상품 Q&A를 수정합니다.\n* 회원정보를 확인하여 본인이 작성한 상품 Q&A만 수정이 가능합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 상품 Q&A 수정 API 개선\n","operationId":"modifyQna","parameters":[{"name":"questNo","in":"path","description":"상품 Q&A 번호","required":true,"schema":{"type":"string"}},{"name":"files","in":"query","description":"멀티미디어 정보","required":true,"schema":{"type":"string","format":"binary"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/GoodsQnaQuestion"}},"required":["question"]}}}},"responses":{"200":{"description":"상품 Q&A 수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"상품 Q&A 수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 상품 Q\&A 삭제
> \## 기능설명\
> \* 상품 Q\&A를 삭제합니다.\
> \---\
> \## 상세설명\
> \* 상품 Q\&A 목록 화면 또는 마이페이지의 상품 Q\&A 화면에서 상품 Q\&A 삭제시 호출됩니다.\
> \* 질문번호를 파라미터로 받아서 해당 질문번호에 해당하는 상품 Q\&A를 삭제합니다.\
> \* 회원정보를 확인하여 본인이 작성한 상품 Q\&A만 삭제가 가능합니다.\
> \* 상품 Q\&A를 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 상품 Q\&A 수정 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":{"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/qna/adv/{questNo}":{"delete":{"tags":["상품 Q&A 관리"],"summary":"상품 Q&A 삭제","description":"## 기능설명\n* 상품 Q&A를 삭제합니다.\n---\n## 상세설명\n* 상품 Q&A 목록 화면 또는 마이페이지의 상품 Q&A 화면에서 상품 Q&A 삭제시 호출됩니다.\n* 질문번호를 파라미터로 받아서 해당 질문번호에 해당하는 상품 Q&A를 삭제합니다.\n* 회원정보를 확인하여 본인이 작성한 상품 Q&A만 삭제가 가능합니다.\n* 상품 Q&A를 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 상품 Q&A 수정 API 개선\n","operationId":"deleteQna","parameters":[{"name":"questNo","in":"path","description":"상품 Q&A 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품 Q&A 삭제 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"상품 Q&A 삭제 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 상품QnA 등록
> \## 기능설명\
> \* 상품 Q\&A를 등록합니다.\
> \---\
> \## 상세설명\
> \* 상품 Q\&A 작성 화면에서 상품Q\&A 작성 후 등록시 호출됩니다.\
> \* 상품 Q\&A를 등록합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 상품 Q\&A 등록 API 개선\
> \
> \`\`\`Release v2.00\_240409\`\`\`: 맵핑 주소에서 /제거.
````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":{"GoodsQnaQuestion":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"questDtm":{"type":"string","format":"date-time","description":"질문일시"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"procId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}},"answerList":{"type":"array","description":"답변 목록","items":{"$ref":"#/components/schemas/GoodsQnaAnswer"}},"deleteGoodsQnaContList":{"type":"array","description":"삭제예정 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"GoodsQnaContents":{"type":"object","description":"상품 Q&A 첨부파일 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명","writeOnly":true},"contSn":{"type":"string","description":"컨텐츠일련번호"}}},"GoodsQnaAnswer":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"prodId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"ansCont":{"type":"string","description":"답변내용"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"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/qna/adv":{"post":{"tags":["상품 Q&A 관리"],"summary":"상품QnA 등록","description":"## 기능설명\n* 상품 Q&A를 등록합니다.\n---\n## 상세설명\n* 상품 Q&A 작성 화면에서 상품Q&A 작성 후 등록시 호출됩니다.\n* 상품 Q&A를 등록합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 상품 Q&A 등록 API 개선\n\n```Release v2.00_240409```: 맵핑 주소에서 /제거.\n","operationId":"insertQna","parameters":[{"name":"files","in":"query","description":"멀티미디어 정보","required":true,"schema":{"type":"string","format":"binary"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/GoodsQnaQuestion"}},"required":["question"]}}}},"responses":{"200":{"description":"상품 Q&A 등록 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}},"900":{"description":"상품 Q&A 등록 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 상품 Q\&A 목록 조회 (통합검색)
> \## 기능설명\
> \* 상품 Q\&A 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 마이페이지 활동현황에서 상품 Q\&A 페이지에 진입시 해당 회원이 작성한 상품 Q\&A 목록 조회를 위해 호출합니다.\
> \* 조회조건 시작일과 종료일 사이 작성한 상품 Q\&A 목록을 조회합니다.\
> \* 별도 조회조건 미설정시 최근 1주일 내 작성된 상품 Q\&A 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 상품 Q\&A\
> \
> \`\`\`Release v2.00\_240409\`\`\`: 질문글 및 답변글의 questCont 값 XSS 필터처리.
````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":{"CommonListData":{"type":"object","properties":{"data":{"type":"array","items":{}},"totalCnt":{"type":"integer","format":"int64"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/qna/adv/member":{"get":{"tags":["상품 Q&A 관리"],"summary":"상품 Q&A 목록 조회 (통합검색)","description":"## 기능설명\n* 상품 Q&A 목록을 조회합니다.\n---\n## 상세설명\n* 마이페이지 활동현황에서 상품 Q&A 페이지에 진입시 해당 회원이 작성한 상품 Q&A 목록 조회를 위해 호출합니다.\n* 조회조건 시작일과 종료일 사이 작성한 상품 Q&A 목록을 조회합니다.\n* 별도 조회조건 미설정시 최근 1주일 내 작성된 상품 Q&A 목록을 조회합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 상품 Q&A\n\n```Release v2.00_240409```: 질문글 및 답변글의 questCont 값 XSS 필터처리.\n","operationId":"getQnaListForMember","parameters":[{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"searchStartDate","in":"query","description":"조회시작일","schema":{"type":"string","description":"localDateTime"}},{"name":"searchEndDate","in":"query","description":"조회종료일","schema":{"type":"string","description":"localDateTime"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품 Q&A 목록 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonListData"}}}},"900":{"description":"상품 Q&A 목록 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 상품별 Q\&A정보 조회
> \## 기능설명\
> \* 상품별 Q\&A 정보 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품번호를 통해 상품별 Q\&A 정보 목록을 조회합니다.\
> \* 상품상세 페이지 진입시 상품상세 하단 상품 Q\&A 영역을 위해 호출합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 상품 Q\&A\
> \
> \`\`\`Release v2.00\_240409\`\`\`: 본인이 작성한 비공개 질문이 아닌경우 답글 정보 제거. 질문글 및 답변글의 questCont 값 XSS 필터처리.
````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":{"GoodsQna":{"type":"object","properties":{"goods":{"$ref":"#/components/schemas/GoodsBase"},"question":{"$ref":"#/components/schemas/GoodsQnaQuestion"},"questionListData":{"$ref":"#/components/schemas/CommonListDataGoodsQnaQuestion"},"questionList":{"type":"array","items":{"$ref":"#/components/schemas/GoodsQnaQuestion"}}}},"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":"표준카테고리번호"}}},"GoodsQnaQuestion":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"questDtm":{"type":"string","format":"date-time","description":"질문일시"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"procId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}},"answerList":{"type":"array","description":"답변 목록","items":{"$ref":"#/components/schemas/GoodsQnaAnswer"}},"deleteGoodsQnaContList":{"type":"array","description":"삭제예정 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"GoodsQnaContents":{"type":"object","description":"상품 Q&A 첨부파일 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명","writeOnly":true},"contSn":{"type":"string","description":"컨텐츠일련번호"}}},"GoodsQnaAnswer":{"type":"object","description":"상품Q&A 질문 정보","properties":{"questNo":{"type":"string","description":"질문번호"},"goodsNo":{"type":"string","description":"상품번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인 아이디"},"mbrStatCd":{"type":"string","description":"회원 상태 코드"},"entrNo":{"type":"string","description":"협력사번호"},"questTypCd":{"type":"string","description":"질문유형코드(PR041)"},"questTitle":{"type":"string","description":"질문제목"},"questCont":{"type":"string","description":"질문내용"},"procStatCd":{"type":"string","description":"처리상태코드(PR039)"},"prodId":{"type":"string","description":"처리자ID"},"notiMethodCd":{"type":"string","description":"알림방법코드(PR040)"},"scrtScrpYn":{"type":"string","description":"비밀글여부"},"kakaoSMScheck":{"type":"string","description":"알림톡/SMS알림동의여부"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"questDispStatCd":{"type":"string","description":"질문전시상태코드(PR022)"},"emailAddr":{"type":"string","description":"이메일주소"},"delYn":{"type":"string","description":"삭제여부"},"ansCont":{"type":"string","description":"답변내용"},"contents":{"type":"array","description":"상품Q&A 첨부파일","items":{"$ref":"#/components/schemas/GoodsQnaContents"}}}},"CommonListDataGoodsQnaQuestion":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GoodsQnaQuestion"}},"totalCnt":{"type":"integer","format":"int64"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/qna/adv/goods/{goodsNo}":{"get":{"tags":["상품 Q&A 관리"],"summary":"상품별 Q&A정보 조회","description":"## 기능설명\n* 상품별 Q&A 정보 목록을 조회합니다.\n---\n## 상세설명\n* 상품번호를 통해 상품별 Q&A 정보 목록을 조회합니다.\n* 상품상세 페이지 진입시 상품상세 하단 상품 Q&A 영역을 위해 호출합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 상품 Q&A\n\n```Release v2.00_240409```: 본인이 작성한 비공개 질문이 아닌경우 답글 정보 제거. 질문글 및 답변글의 questCont 값 XSS 필터처리.\n","operationId":"getQnaAndGoods","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품별 상품 Q&A 정보 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsQna"}}}},"900":{"description":"상품별 상품 Q&A 정보 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/goods-api/q-and-a.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.