> 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/order-api/faq.md).
# 공지사항 FAQ
## 공지사항, FAQ 조회 수 증가
> \## 기능설명\
> \* 공지사항, FAQ 조회 수를 증가합니다.\
> \---\
> \## 상세설명\
> \* 선택한 공지사항, FAQ의 조회 수를 증가시킵니다.\
> \---\
> \## 코드정리\
> \* \`\`\`파라미터구분값(paramGubun)\`\`\` : NO:공지사항, FAQ:FAQ
````json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/customerservice/questionReadCntSave":{"put":{"tags":["공지사항 FAQ"],"summary":"공지사항, FAQ 조회 수 증가","description":"## 기능설명\n* 공지사항, FAQ 조회 수를 증가합니다.\n---\n## 상세설명\n* 선택한 공지사항, FAQ의 조회 수를 증가시킵니다.\n---\n## 코드정리\n* ```파라미터구분값(paramGubun)``` : NO:공지사항, FAQ:FAQ\n","operationId":"questionReadCntSave","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadCntRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseReadCntResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ReadCntRequest":{"type":"object","properties":{"paramGubun":{"type":"string","description":"파라미터구분값(NO:공지사항, FAQ:FAQ)"},"seqNo":{"type":"string","description":"조회수"}},"description":"공지사항, FAQ 조회 수 증가 요청 DTO"},"ResponseReadCntResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/ReadCntResponse"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ReadCntResponse":{"type":"object","description":"payload"},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}}}
````
## 공지사항 목록 조회
> \## 기능설명\
> \* 고객센터 공지사항 목록을 조회한다.\
> \---\
> \## 상세설명\
> \* 현재 전시중인 공지사항 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v2.00\_240425\`\`\`: 멀티사이트 테이블 컬럼 추가(SITE\_NO)로 인한 조회 쿼리 수정
````json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/customerservice/notice":{"get":{"tags":["공지사항 FAQ"],"summary":"공지사항 목록 조회","description":"## 기능설명\n* 고객센터 공지사항 목록을 조회한다.\n---\n## 상세설명\n* 현재 전시중인 공지사항 목록을 조회합니다.\n---\n## 수정번호\n* ```Release v2.00_240425```: 멀티사이트 테이블 컬럼 추가(SITE_NO)로 인한 조회 쿼리 수정\n","operationId":"getNotice","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통","required":false,"schema":{"type":"string","description":"전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통"}},{"name":"searchText","in":"query","description":"제목, 내용","required":false,"schema":{"type":"string","description":"제목, 내용"}},{"name":"ntcClssCd","in":"query","description":"공지분류코드(DP019)
10:일반공지, 20:이벤트공지","required":false,"schema":{"type":"string","description":"공지분류코드(DP019)
10:일반공지, 20:이벤트공지"}},{"name":"uprFixYn","in":"query","description":"최상단여부체크","required":false,"schema":{"type":"string","description":"최상단여부체크"}},{"name":"ntcNo","in":"query","description":"공지번호","required":false,"schema":{"type":"string","description":"공지번호"}},{"name":"uprFixCnt","in":"query","description":"목록조회 시 상단고정글 갯수","required":false,"schema":{"type":"string","description":"목록조회 시 상단고정글 갯수"}},{"name":"pagingYn","in":"query","description":"페이징처리여부","required":false,"schema":{"type":"string","description":"페이징처리여부"}},{"name":"rowsPerPage","in":"query","description":"화면당노출수량","required":false,"schema":{"type":"string","description":"화면당노출수량"}},{"name":"pageIdx","in":"query","description":"페이지번호","required":false,"schema":{"type":"string","description":"페이지번호"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseNoticeSrhResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ResponseNoticeSrhResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/NoticeSrhResponse"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"NoticeSrhResponse":{"type":"object","properties":{"allPageCnt":{"type":"integer","description":"전체페이지개수","format":"int32"},"curPageNo":{"type":"integer","description":"현재페이지번호","format":"int32"},"allCnt":{"type":"integer","description":"전체페이지개수","format":"int32"},"sysBbInfo":{"type":"array","description":"공지사항 상세정보","items":{"$ref":"#/components/schemas/NoticeComResponse"}}},"description":"payload"},"NoticeComResponse":{"type":"object","properties":{"ntcNo":{"type":"string","description":"글번호"},"ntcClssNm":{"type":"string","description":"공지분류명"},"ntcClssCd":{"type":"string","description":"공지분류코드"},"uprFixYn":{"type":"string","description":"상단고정여부"},"title":{"type":"string","description":"제목"},"ntcCont":{"type":"string","description":"게시글내용"},"bbStrDtm":{"type":"string","description":"게시시작일시"},"regDt":{"type":"string","description":"등록일"},"sortSeq":{"type":"string","description":"정렬순서"}},"description":"공지사항 상세정보"},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}}}
````
## 공지사항 상세 조회
> \## 기능설명\
> \* 공지사항 상세내용을 조회한다.\
> \---\
> \## 상세설명\
> \* 선택한 공지사항 상세내용을 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v2.00\_240425\`\`\`: 멀티사이트 테이블 컬럼 추가(SITE\_NO)로 인한 조회 쿼리 수정
````json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/customerservice/noticeDtl":{"get":{"tags":["공지사항 FAQ"],"summary":"공지사항 상세 조회","description":"## 기능설명\n* 공지사항 상세내용을 조회한다.\n---\n## 상세설명\n* 선택한 공지사항 상세내용을 조회합니다.\n---\n## 수정번호\n* ```Release v2.00_240425```: 멀티사이트 테이블 컬럼 추가(SITE_NO)로 인한 조회 쿼리 수정\n","operationId":"getNoticeDtl","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통","required":false,"schema":{"type":"string","description":"전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통"}},{"name":"ntcNo","in":"query","description":"공지번호","required":false,"schema":{"type":"string","description":"공지번호"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseNoticeDtlResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ResponseNoticeDtlResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/NoticeDtlResponse"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"NoticeDtlResponse":{"type":"object","properties":{"allPageCnt":{"type":"integer","description":"전체페이지개수","format":"int32"},"curPageNo":{"type":"integer","description":"현재페이지번호","format":"int32"},"sysBbInfo":{"type":"array","description":"상세정보","items":{"$ref":"#/components/schemas/NoticeComResponse"}}},"description":"payload"},"NoticeComResponse":{"type":"object","properties":{"ntcNo":{"type":"string","description":"글번호"},"ntcClssNm":{"type":"string","description":"공지분류명"},"ntcClssCd":{"type":"string","description":"공지분류코드"},"uprFixYn":{"type":"string","description":"상단고정여부"},"title":{"type":"string","description":"제목"},"ntcCont":{"type":"string","description":"게시글내용"},"bbStrDtm":{"type":"string","description":"게시시작일시"},"regDt":{"type":"string","description":"등록일"},"sortSeq":{"type":"string","description":"정렬순서"}},"description":"공지사항 상세정보"},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}}}
````
## FAQ 조회
> \## 기능설명\
> \* FAQ 목록과 상세를 조회한다.\
> \---\
> \## 상세설명\
> \* FAQ 목록과 상세 정보를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/customerservice/faqInit":{"get":{"tags":["공지사항 FAQ"],"summary":"FAQ 조회","description":"## 기능설명\n* FAQ 목록과 상세를 조회한다.\n---\n## 상세설명\n* FAQ 목록과 상세 정보를 조회합니다.\n---\n## 수정번호\n* Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가\n","operationId":"getFaqInit","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통","required":false,"schema":{"type":"string","description":"전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통"}},{"name":"faqLgrpCd","in":"query","description":"FAQ대분류코드(CM014)
20:주문배송, 30:결제환불, 40:교환반품, 60:쿠폰혜택, 70:상품문의, 80:사이트이용, 90:기타","required":false,"schema":{"type":"string","description":"FAQ대분류코드(CM014)
20:주문배송, 30:결제환불, 40:교환반품, 60:쿠폰혜택, 70:상품문의, 80:사이트이용, 90:기타"}},{"name":"searchText","in":"query","description":"제목+내용","required":false,"schema":{"type":"string","description":"제목+내용"}},{"name":"pagingYn","in":"query","description":"페이징처리여부","required":false,"schema":{"type":"string","description":"페이징처리여부"}},{"name":"rowsPerPage","in":"query","description":"화면당노출수량","required":false,"schema":{"type":"string","description":"화면당노출수량"}},{"name":"pageIdx","in":"query","description":"페이지번호","required":false,"schema":{"type":"string","description":"페이지번호"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseFaqSrhResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ResponseFaqSrhResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/FaqSrhResponse"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"FaqSrhResponse":{"type":"object","properties":{"allPageCnt":{"type":"integer","description":"전체페이지개수","format":"int32"},"curPageNo":{"type":"integer","description":"현재페이지번호","format":"int32"},"faqInfo":{"type":"array","description":"상세","items":{"$ref":"#/components/schemas/FaqComResponse"}}},"description":"payload"},"FaqComResponse":{"type":"object","properties":{"faqNo":{"type":"string","description":"FAQ번호"},"faqLgrpCd":{"type":"string","description":"FAQ대분류코드"},"faqLgrpNm":{"type":"string","description":"FAQ대분류명"},"faqMgrpNm":{"type":"string","description":"FAQ중분류명"},"uprFixYn":{"type":"string","description":"상단고정여부"},"title":{"type":"string","description":"제목"},"ntcCont":{"type":"string","description":"공지내용"},"sortSeq":{"type":"string","description":"정렬순서"}},"description":"상세"},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}}}
```