# 시스템 공지 관리
## 시스템 공지 수정/삭제
> \## 기능설명\
> \* 시스템 공지를 수정, 삭제합니다.\
> \---\
> \## 상세설명\
> \* 팝업여부(popYn)를 Y로 등록하면 메인 접속 시 팝업 공지사항으로 노출됩니다.\
> \* 공지구분코드가 개별공지로 넘어올 경우 공지대상을 등록하여 대상에 등록된 아이디로 로그인 시 공지를 노출합니다.\
> \* 제목(title), 시스템구분코드(sysGbCd), 게시글 내용(bbcCont)은 필수입니다.\
> \* 게시여부(bbYn)를 Y로 수정 시 게시시작일시(bbStrDtm), 게시종료일시(bbEndDtm)는 필수입니다.\
> \* 팝업여부(popYn)를 Y로 수정 시 팝업게시시작일시(popBbStrDtm), 팝업게시종료일시(popBbEndDtm)는 필수입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ModifySystemNoticeRequest":{"type":"object","description":"시스템 공지 수정 요청 DTO","properties":{"req":{"$ref":"#/components/schemas/SystemNoticeCudRequest","description":"시스템 공지 수정 정보"},"cudList":{"$ref":"#/components/schemas/RealGridCUDRequestStUserBase","description":"공지대상 정보"}}},"SystemNoticeCudRequest":{"type":"object","description":"시스템 공지 등록, 수정 요청 DTO","properties":{"bbcNo":{"type":"string","description":"공지번호"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)","minLength":1},"sysGbDtlCd":{"type":"string","description":"시스템구분상세코드"},"bbGbCd":{"type":"string","description":"게시판구분코드(CM004)","minLength":1},"title":{"type":"string","description":"제목","minLength":1},"fxdcYn":{"type":"string","description":"고정글여부","enum":["Y","N"],"minLength":1},"ntcGbCd":{"type":"string","description":"공지구분코드(CM005)"},"ntcTypCd":{"type":"string","description":"공지유형코드(CM006)"},"smsSndYn":{"type":"string","description":"SMS발송여부","enum":["Y","N"],"minLength":1},"emailSndYn":{"type":"string","description":"이메일발송여부","enum":["Y","N"],"minLength":1},"bbYn":{"type":"string","description":"게시여부","enum":["Y","N"],"minLength":1},"bbStrDtm":{"type":"string","format":"date-time","description":"게시시작일시"},"bbEndDtm":{"type":"string","format":"date-time","description":"게시종료일시"},"popYn":{"type":"string","description":"팝업여부","enum":["Y","N"],"minLength":1},"popBbStrDtm":{"type":"string","format":"date-time","description":"팝업게시시작일시"},"popBbEndDtm":{"type":"string","format":"date-time","description":"팝업게시종료일시"},"bbcCont":{"type":"string","description":"게시글내용","minLength":1},"qryCnt":{"type":"integer","format":"int32","description":"조회수"},"tmpFileList":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeFileCudRequest"}},"delFileList":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeFileCudRequest"}}},"required":["bbGbCd","bbYn","bbcCont","emailSndYn","fxdcYn","popYn","smsSndYn","sysGbCd","title"]},"SystemNoticeFileCudRequest":{"type":"object","properties":{"bbcNo":{"type":"string"},"fileSeq":{"type":"integer","format":"int32"},"atchFileNm":{"type":"string"},"atchFileRouteNm":{"type":"string"},"reAtchFileNm":{"type":"string"}}},"RealGridCUDRequestStUserBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}}}},"StUserBase":{"type":"object","description":"사용자 정보 Entity","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)"},"deptCd":{"type":"string","description":"부서코드"},"deptNm":{"type":"string","description":"부서명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사 명"},"userNm":{"type":"string","description":"사용자명"},"pwd":{"type":"string","description":"비밀번호"},"sysGbCd":{"type":"string","description":"시스템 그룹 번호"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹 명"},"useYn":{"type":"string","description":"사용여부"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호"},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호"},"emailAddr":{"type":"string","description":"이메일 주소"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"indInfoDealCausCont":{"type":"string","description":"개인 정보 취급 사유 내용"},"empNo":{"type":"string","description":"사원번호"},"jobGrpCd":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"ocpCd":{"type":"string","description":"직책코드(UR003)"},"workStatCd":{"type":"string","description":"근무 상태코드(UR004)"},"atchFileRouteNm":{"type":"string","description":"첨부 파일 경로 명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부 파일명(현재 미사용)"},"useStrtDt":{"type":"string","description":"사용 시작 일자"},"useEndDt":{"type":"string","description":"사용 종료 일자"},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"itelNo":{"type":"string","description":"내선번호"},"ctiNo":{"type":"string","description":"CTI번호"},"rcntUseDtm":{"type":"string","format":"date-time","description":"최근 사용 일시"},"pwdLockRvcmnId":{"type":"string","description":"잠김 해제 처리지"},"pwdLockRvcDtm":{"type":"string","format":"date-time","description":"잠김 해제 처리 일시"},"pwdCntnFailCnt":{"type":"integer","format":"int64","description":"비밀번호 연속 실패 수"},"lstPwdChgDtm":{"type":"string","format":"date-time","description":"최종 비밀번호 변경 일시"},"pwdLockYn":{"type":"string","description":"비밀번호 잠김 여부"},"pwdIniYn":{"type":"string","description":"비밀번호 초기화 여부"},"userIpAddr":{"type":"string","description":"접근허용 IP"}}},"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"}}}}},"paths":{"/v1/system/systemNoticeMgmt/modifySystemNoticeInfo":{"put":{"tags":["시스템 공지 관리"],"summary":"시스템 공지 수정/삭제","description":"## 기능설명\n* 시스템 공지를 수정, 삭제합니다.\n---\n## 상세설명\n* 팝업여부(popYn)를 Y로 등록하면 메인 접속 시 팝업 공지사항으로 노출됩니다.\n* 공지구분코드가 개별공지로 넘어올 경우 공지대상을 등록하여 대상에 등록된 아이디로 로그인 시 공지를 노출합니다.\n* 제목(title), 시스템구분코드(sysGbCd), 게시글 내용(bbcCont)은 필수입니다.\n* 게시여부(bbYn)를 Y로 수정 시 게시시작일시(bbStrDtm), 게시종료일시(bbEndDtm)는 필수입니다.\n* 팝업여부(popYn)를 Y로 수정 시 팝업게시시작일시(popBbStrDtm), 팝업게시종료일시(popBbEndDtm)는 필수입니다.\n","operationId":"modifySystemNoticeInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModifySystemNoticeRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시스템 공지 첨부파일 업로드
> \## 기능설명\
> \* 시스템 공지 첨부파일을 S3에 업로드합니다.\
> \---\
> \## 상세설명\
> \* 시스템 공지에 등록한 첨부파일을 S3에 업로드합니다.\
> \* 업로드한 파일의 S3 경로를 전달합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","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"}}}}},"paths":{"/v2/system/systemNoticeMgmt/uploadFile":{"post":{"tags":["시스템 공지 관리"],"summary":"시스템 공지 첨부파일 업로드","description":"## 기능설명\n* 시스템 공지 첨부파일을 S3에 업로드합니다.\n---\n## 상세설명\n* 시스템 공지에 등록한 첨부파일을 S3에 업로드합니다.\n* 업로드한 파일의 S3 경로를 전달합니다.\n","operationId":"upLoadFile","parameters":[{"name":"files","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","format":"binary"}}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string"}}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시스템 공지 등록
> \## 기능설명\
> \* 시스템 공지를 등록합니다.\
> \---\
> \## 상세설명\
> \* 팝업여부(popYn)를 Y로 등록하면 메인 접속 시 팝업 공지사항으로 노출됩니다.\
> \* 공지구분코드가 개별공지로 넘어올 경우 공지대상을 등록하여 대상에 등록된 아이디로 로그인 시 공지를 노출합니다.\
> \* 제목(title), 시스템구분코드(sysGbCd), 게시글 내용(bbcCont)은 필수입니다.\
> \* 게시여부(bbYn)를 Y로 할 시 게시시작일시(bbStrDtm), 게시종료일시(bbEndDtm)는 필수입니다.\
> \* 팝업여부(popYn)를 Y로 할 시 팝업게시시작일시(popBbStrDtm), 팝업게시종료일시(popBbEndDtm)는 필수입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RegisterSystemNoticeRequest":{"type":"object","description":"시스템 공지 등록 요청 DTO","properties":{"req":{"$ref":"#/components/schemas/SystemNoticeCudRequest","description":"시스템 공지 등록 정보"},"cudList":{"$ref":"#/components/schemas/RealGridCUDRequestStUserBase","description":"공지대상 정보"}}},"SystemNoticeCudRequest":{"type":"object","description":"시스템 공지 등록, 수정 요청 DTO","properties":{"bbcNo":{"type":"string","description":"공지번호"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)","minLength":1},"sysGbDtlCd":{"type":"string","description":"시스템구분상세코드"},"bbGbCd":{"type":"string","description":"게시판구분코드(CM004)","minLength":1},"title":{"type":"string","description":"제목","minLength":1},"fxdcYn":{"type":"string","description":"고정글여부","enum":["Y","N"],"minLength":1},"ntcGbCd":{"type":"string","description":"공지구분코드(CM005)"},"ntcTypCd":{"type":"string","description":"공지유형코드(CM006)"},"smsSndYn":{"type":"string","description":"SMS발송여부","enum":["Y","N"],"minLength":1},"emailSndYn":{"type":"string","description":"이메일발송여부","enum":["Y","N"],"minLength":1},"bbYn":{"type":"string","description":"게시여부","enum":["Y","N"],"minLength":1},"bbStrDtm":{"type":"string","format":"date-time","description":"게시시작일시"},"bbEndDtm":{"type":"string","format":"date-time","description":"게시종료일시"},"popYn":{"type":"string","description":"팝업여부","enum":["Y","N"],"minLength":1},"popBbStrDtm":{"type":"string","format":"date-time","description":"팝업게시시작일시"},"popBbEndDtm":{"type":"string","format":"date-time","description":"팝업게시종료일시"},"bbcCont":{"type":"string","description":"게시글내용","minLength":1},"qryCnt":{"type":"integer","format":"int32","description":"조회수"},"tmpFileList":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeFileCudRequest"}},"delFileList":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeFileCudRequest"}}},"required":["bbGbCd","bbYn","bbcCont","emailSndYn","fxdcYn","popYn","smsSndYn","sysGbCd","title"]},"SystemNoticeFileCudRequest":{"type":"object","properties":{"bbcNo":{"type":"string"},"fileSeq":{"type":"integer","format":"int32"},"atchFileNm":{"type":"string"},"atchFileRouteNm":{"type":"string"},"reAtchFileNm":{"type":"string"}}},"RealGridCUDRequestStUserBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StUserBase"}}}},"StUserBase":{"type":"object","description":"사용자 정보 Entity","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)"},"deptCd":{"type":"string","description":"부서코드"},"deptNm":{"type":"string","description":"부서명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사 명"},"userNm":{"type":"string","description":"사용자명"},"pwd":{"type":"string","description":"비밀번호"},"sysGbCd":{"type":"string","description":"시스템 그룹 번호"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹 명"},"useYn":{"type":"string","description":"사용여부"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호"},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호"},"emailAddr":{"type":"string","description":"이메일 주소"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"indInfoDealCausCont":{"type":"string","description":"개인 정보 취급 사유 내용"},"empNo":{"type":"string","description":"사원번호"},"jobGrpCd":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"ocpCd":{"type":"string","description":"직책코드(UR003)"},"workStatCd":{"type":"string","description":"근무 상태코드(UR004)"},"atchFileRouteNm":{"type":"string","description":"첨부 파일 경로 명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부 파일명(현재 미사용)"},"useStrtDt":{"type":"string","description":"사용 시작 일자"},"useEndDt":{"type":"string","description":"사용 종료 일자"},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"itelNo":{"type":"string","description":"내선번호"},"ctiNo":{"type":"string","description":"CTI번호"},"rcntUseDtm":{"type":"string","format":"date-time","description":"최근 사용 일시"},"pwdLockRvcmnId":{"type":"string","description":"잠김 해제 처리지"},"pwdLockRvcDtm":{"type":"string","format":"date-time","description":"잠김 해제 처리 일시"},"pwdCntnFailCnt":{"type":"integer","format":"int64","description":"비밀번호 연속 실패 수"},"lstPwdChgDtm":{"type":"string","format":"date-time","description":"최종 비밀번호 변경 일시"},"pwdLockYn":{"type":"string","description":"비밀번호 잠김 여부"},"pwdIniYn":{"type":"string","description":"비밀번호 초기화 여부"},"userIpAddr":{"type":"string","description":"접근허용 IP"}}},"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"}}}}},"paths":{"/v1/system/systemNoticeMgmt/registSystemNoticeInfo":{"post":{"tags":["시스템 공지 관리"],"summary":"시스템 공지 등록","description":"## 기능설명\n* 시스템 공지를 등록합니다.\n---\n## 상세설명\n* 팝업여부(popYn)를 Y로 등록하면 메인 접속 시 팝업 공지사항으로 노출됩니다.\n* 공지구분코드가 개별공지로 넘어올 경우 공지대상을 등록하여 대상에 등록된 아이디로 로그인 시 공지를 노출합니다.\n* 제목(title), 시스템구분코드(sysGbCd), 게시글 내용(bbcCont)은 필수입니다.\n* 게시여부(bbYn)를 Y로 할 시 게시시작일시(bbStrDtm), 게시종료일시(bbEndDtm)는 필수입니다.\n* 팝업여부(popYn)를 Y로 할 시 팝업게시시작일시(popBbStrDtm), 팝업게시종료일시(popBbEndDtm)는 필수입니다.\n","operationId":"registSystemNoticeInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterSystemNoticeRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시스템 공지대상 목록 조회
> \## 기능설명\
> \* 공지번호에 대한 공지대상 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 공지번호(bbcNo)는 필수입니다.\
> \* 공지번호에 등록된 공지대상과 같은 권한이 있는 대상을 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponseSystemNoticeTargetInfoResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeTargetInfoResponse"}}}},"SystemNoticeTargetInfoResponse":{"type":"object","properties":{"userId":{"type":"string"},"userNm":{"type":"string"},"jobGrpCd":{"type":"string"},"orgTypNm":{"type":"string"},"workStatCd":{"type":"string"},"workStatNm":{"type":"string"}}},"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"}}}}},"paths":{"/v2/system/systemNoticeMgmt/getSystemNoticeTargetInfoList":{"get":{"tags":["시스템 공지 관리"],"summary":"시스템 공지대상 목록 조회","description":"## 기능설명\n* 공지번호에 대한 공지대상 목록을 조회합니다.\n---\n## 상세설명\n* 공지번호(bbcNo)는 필수입니다.\n* 공지번호에 등록된 공지대상과 같은 권한이 있는 대상을 조회합니다.\n","operationId":"getSystemNoticeTargetInfoList","parameters":[{"name":"bbcNo","in":"query","description":"공지번호","required":true,"schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSystemNoticeTargetInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시스템 공지 목록 조회
> \## 기능설명\
> \* 화면에서 넘어온 파라미터에 맞는 시스템 공지를 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 넘어온 파라미터에 맞는 시스템 공지 건수를 조회합니다.\
> \* 조회시작일시, 종료일시는 필수입니다.\
> \* 기간구분코드는 필수입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SystemNoticeListRequest":{"type":"object","properties":{"sysGbCd":{"type":"string"},"bbGbCd":{"type":"string"},"termGbCd":{"type":"string"},"strDtm":{"type":"string","format":"date"},"endDtm":{"type":"string","format":"date"},"dateSelect":{"type":"string"},"bbYn":{"type":"string"},"ntcGbCd":{"type":"string"},"title":{"type":"string"},"sysRegUserId":{"type":"string"},"ntcTypCd":{"type":"string"}}},"RealGridListResponseSystemNoticeListResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeListResponse"}}}},"SystemNoticeListResponse":{"type":"object","properties":{"bbcNo":{"type":"string"},"sysGbNm":{"type":"string"},"bbGbNm":{"type":"string"},"ntcGbNm":{"type":"string"},"title":{"type":"string"},"bbYn":{"type":"string"},"bbStrDtm":{"type":"string","format":"date-time"},"bbEndDtm":{"type":"string","format":"date-time"},"fxdcYn":{"type":"string"},"popYn":{"type":"string"},"qryCnt":{"type":"integer","format":"int32"},"ntcTypNm":{"type":"string"}}},"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"}}}}},"paths":{"/v2/system/systemNoticeMgmt/getSystemNoticeList":{"get":{"tags":["시스템 공지 관리"],"summary":"시스템 공지 목록 조회","description":"## 기능설명\n* 화면에서 넘어온 파라미터에 맞는 시스템 공지를 조회합니다.\n---\n## 상세설명\n* 화면에서 넘어온 파라미터에 맞는 시스템 공지 건수를 조회합니다.\n* 조회시작일시, 종료일시는 필수입니다.\n* 기간구분코드는 필수입니다.\n---\n## 수정번호\n* Release v2.00_240530: 날짜조회 쿼리 변경\n","operationId":"getSystemNoticeList","parameters":[{"name":"systemNoticeListRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SystemNoticeListRequest"}},{"name":"sysGbCd","in":"query","description":"시스템구분코드","schema":{"type":"string"}},{"name":"bbGbCd","in":"query","description":"게시판구분코드","schema":{"type":"string"}},{"name":"termGbCd","in":"query","description":"기간구분(등록일/게시일)","required":true,"schema":{"type":"string"}},{"name":"strDtm","in":"query","description":"시작일시","required":true,"schema":{"type":"LocalDate"}},{"name":"endDtm","in":"query","description":"종료일시","required":true,"schema":{"type":"LocalDate"}},{"name":"bbYn","in":"query","description":"게시여부","schema":{"type":"string"}},{"name":"ntcGbCd","in":"query","description":"공지구분코드","schema":{"type":"string"}},{"name":"title","in":"query","description":"제목","schema":{"type":"string"}},{"name":"sysRegUserId","in":"query","description":"등록자 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSystemNoticeListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시스템 공지 단건 조회
> \## 기능설명\
> \* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\
> \* 넘어온 공지번호에 맞는 시스템 공지 첨부파일이 존재할 시 함께 조회됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SystemNoticeInfoResponse":{"type":"object","properties":{"stSysBbInfo":{"$ref":"#/components/schemas/StSysBbInfo"},"atchFileList":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeAttachFileResponse"}}}},"StSysBbInfo":{"type":"object","properties":{"bbcNo":{"type":"string"},"sysGbCd":{"type":"string"},"bbGbCd":{"type":"string"},"title":{"type":"string"},"fxdcYn":{"type":"string"},"ntcGbCd":{"type":"string"},"ntcTypCd":{"type":"string"},"smsSndYn":{"type":"string"},"emailSndYn":{"type":"string"},"bbYn":{"type":"string"},"bbStrDtm":{"type":"string","format":"date-time"},"bbEndDtm":{"type":"string","format":"date-time"},"popYn":{"type":"string"},"popBbStrDtm":{"type":"string","format":"date-time"},"popBbEndDtm":{"type":"string","format":"date-time"},"bbcCont":{"type":"string"},"qryCnt":{"type":"integer","format":"int32"},"sysRegNm":{"type":"string"}}},"SystemNoticeAttachFileResponse":{"type":"object","description":"시스템 공지 첨부파일 응답 DTO","properties":{"bbcNo":{"type":"string","description":"공지번호"},"fileSeq":{"type":"integer","format":"int32","description":"첨부파일번호"},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명"},"atchFileNm":{"type":"string","description":"첨부파일명"},"atchFileDnldCnt":{"type":"integer","format":"int32","description":"첨부파일 다운로드수"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/systemNoticeMgmt/getSystemNoticeInfo":{"get":{"tags":["시스템 공지 관리"],"summary":"시스템 공지 단건 조회","description":"## 기능설명\n* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\n---\n## 상세설명\n* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\n* 넘어온 공지번호에 맞는 시스템 공지 첨부파일이 존재할 시 함께 조회됩니다.\n","operationId":"getSystemNoticeInfo","parameters":[{"name":"bbcNo","in":"query","description":"공지번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SystemNoticeInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시스템 공지 단건 조회
> \## 기능설명\
> \* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\
> \* 넘어온 공지번호에 맞는 시스템 공지 첨부파일이 존재할 시 함께 조회됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SystemNoticeInfoResponse":{"type":"object","properties":{"stSysBbInfo":{"$ref":"#/components/schemas/StSysBbInfo"},"atchFileList":{"type":"array","items":{"$ref":"#/components/schemas/SystemNoticeAttachFileResponse"}}}},"StSysBbInfo":{"type":"object","properties":{"bbcNo":{"type":"string"},"sysGbCd":{"type":"string"},"bbGbCd":{"type":"string"},"title":{"type":"string"},"fxdcYn":{"type":"string"},"ntcGbCd":{"type":"string"},"ntcTypCd":{"type":"string"},"smsSndYn":{"type":"string"},"emailSndYn":{"type":"string"},"bbYn":{"type":"string"},"bbStrDtm":{"type":"string","format":"date-time"},"bbEndDtm":{"type":"string","format":"date-time"},"popYn":{"type":"string"},"popBbStrDtm":{"type":"string","format":"date-time"},"popBbEndDtm":{"type":"string","format":"date-time"},"bbcCont":{"type":"string"},"qryCnt":{"type":"integer","format":"int32"},"sysRegNm":{"type":"string"}}},"SystemNoticeAttachFileResponse":{"type":"object","description":"시스템 공지 첨부파일 응답 DTO","properties":{"bbcNo":{"type":"string","description":"공지번호"},"fileSeq":{"type":"integer","format":"int32","description":"첨부파일번호"},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명"},"atchFileNm":{"type":"string","description":"첨부파일명"},"atchFileDnldCnt":{"type":"integer","format":"int32","description":"첨부파일 다운로드수"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/systemNoticeMgmt/getSystemNoticeInfo":{"get":{"tags":["시스템 공지 관리"],"summary":"시스템 공지 단건 조회","description":"## 기능설명\n* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\n---\n## 상세설명\n* 넘어온 공지번호에 맞는 시스템 공지 정보를 조회합니다.\n* 넘어온 공지번호에 맞는 시스템 공지 첨부파일이 존재할 시 함께 조회됩니다.\n","operationId":"getSystemNoticeInfo_1","parameters":[{"name":"bbcNo","in":"query","description":"공지번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SystemNoticeInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 대시보드 시스템공지 목록 조회
> \## 기능설명\
> \* 대시보드 메인 공지사항 및 팝업 공지사항을 조회합니다.\
> \---\
> \## 상세설명\
> \* 팝업여부(popYn)이 Y로 오면 팝업 공지사항을 조회합니다.\
> \* 현재날짜가 게시시작일시, 게시종료일시 사이에 있으면 조회됩니다.\
> \* 접속한 시스템구분코드의 전체공지 목록과, 로그인한 ID와 동일 업체번호를 가진 개별공지 목록을 합해 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DashboardNoticeRequest":{"type":"object","properties":{"sysRegId":{"type":"string","description":"등록자 ID"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"bbGbCd":{"type":"string","description":"게시판구분코드(CM004)"},"termGbCd":{"type":"string","description":"기간구분(등록일/게시일)"},"strDtm":{"type":"string","description":"게시시작일"},"endDtm":{"type":"string","description":"게시종료일"},"bbYn":{"type":"string","description":"게시여부"},"ntcGbCd":{"type":"string","description":"공지구분코드(CM005)"},"bbcNo":{"type":"string","description":"공지번호"},"popYn":{"type":"string","description":"팝업여부"}}},"DashboardNoticeResponse":{"type":"object","properties":{"bbcNo":{"type":"string","description":"공지번호"},"sysGbNm":{"type":"string","description":"시스템구분"},"bbGbNm":{"type":"string","description":"게시구분"},"bbGbCd":{"type":"string","description":"게시구분코드"},"ntcTypCd":{"type":"string","description":"공지유형코드"},"ntcGbNm":{"type":"string","description":"공지구분"},"title":{"type":"string","description":"제목"},"bbYn":{"type":"string","description":"게시여부","enum":["Y","N"]},"bbStrDtm":{"type":"string","format":"date-time","description":"게시시작일"},"bbEndDtm":{"type":"string","format":"date-time","description":"게시종료일"},"fxdcYn":{"type":"string","description":"고정글여부","enum":["Y","N"]},"popYn":{"type":"string","description":"팝업여부","enum":["Y","N"]},"qryCnt":{"type":"integer","format":"int32","description":"조회수"},"sysRegDte":{"type":"string","description":"등록일"},"bbcCont":{"type":"string","description":"공지내용"},"fileList":{"type":"array","description":"첨부파일 리스트","items":{"$ref":"#/components/schemas/SystemNoticeAttachFileResponse"}},"ntcTypNm":{"type":"string"},"sysRegNm":{"type":"string","description":"등록자명"},"fileCount":{"type":"integer","format":"int32","description":"첨부파일개수"}}},"SystemNoticeAttachFileResponse":{"type":"object","description":"시스템 공지 첨부파일 응답 DTO","properties":{"bbcNo":{"type":"string","description":"공지번호"},"fileSeq":{"type":"integer","format":"int32","description":"첨부파일번호"},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명"},"atchFileNm":{"type":"string","description":"첨부파일명"},"atchFileDnldCnt":{"type":"integer","format":"int32","description":"첨부파일 다운로드수"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/systemNoticeMgmt/getSystemNoticeInfoListByToday":{"get":{"tags":["시스템 공지 관리"],"summary":"대시보드 시스템공지 목록 조회","description":"## 기능설명\n* 대시보드 메인 공지사항 및 팝업 공지사항을 조회합니다.\n---\n## 상세설명\n* 팝업여부(popYn)이 Y로 오면 팝업 공지사항을 조회합니다.\n* 현재날짜가 게시시작일시, 게시종료일시 사이에 있으면 조회됩니다.\n* 접속한 시스템구분코드의 전체공지 목록과, 로그인한 ID와 동일 업체번호를 가진 개별공지 목록을 합해 조회합니다.\n","operationId":"getSystemNoticeInfoListByToday_1","parameters":[{"name":"dashboardNoticeRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/DashboardNoticeRequest"}},{"name":"sysGbCd","in":"query","description":"시스템구분코드","schema":{"type":"string"}},{"name":"bbGbCd","in":"query","description":"게시유형코드","schema":{"type":"string"}},{"name":"strDtm","in":"query","description":"게시시작일시","schema":{"type":"string"}},{"name":"endDtm","in":"query","description":"게시종료일시","schema":{"type":"string"}},{"name":"popYn","in":"query","description":"팝업여부","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DashboardNoticeResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# 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/back-office-api/system-bo-api/undefined-2.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.