# 공지사항 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"}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/order-api/faq.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.