> 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/back-office-api/display-bo-api/undefined-12.md).
# 구좌 관리
## 구좌 목록 조회
> \## 기능설명\
> \* 전체 구좌 목록을 조회한다.\
> \---\
> \## 상세설명\
> \* \[BO] 전시 > 전시연결관리 > 구좌관리 > 구좌목록 그리드 영역\
> \* 조회 조건에 따라 구좌 목록을 조회한다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 구좌 관리 최초 개발\
> \* \`\`\`Release\`\`\` : 구좌사이트몰맵핑 테이블로 구좌:몰 1:N 개념 추가
````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":{"PrDispAdutInfo":{"type":"object","description":"구좌 관리","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"adutId":{"type":"string","description":"구좌ID"},"adutNm":{"type":"string","description":"구좌명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰 번호"},"dpmlNoList":{"type":"array","description":"몰 번호 목록","items":{"type":"string"}},"dpmlNm":{"type":"string","description":"전시몰명"},"tmplConrNo":{"type":"string","description":"템플릿코너번호"},"conrNo":{"type":"string","description":"코너번호"},"conrNm":{"type":"string","description":"코너명"},"shopNo":{"type":"string","description":"매장번호"},"dispShopNm":{"type":"string","description":"전시매장명"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispMediaNm":{"type":"string","description":"전시매체코드명(DP018)"},"mappTtl":{"type":"string","description":"매핑타이틀"},"useYn":{"type":"string","description":"사용여부"},"templCornerDispYn":{"type":"string","description":"템플릿코너전시여부"},"shopDispYn":{"type":"string","description":"매장전시여부"},"updateFlag":{"type":"string","description":"수정 상태 여부"},"totalCount":{"type":"integer","format":"int32","description":"총 갯수"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account":{"get":{"tags":["구좌 관리"],"summary":"구좌 목록 조회","description":"## 기능설명\n* 전체 구좌 목록을 조회한다.\n---\n## 상세설명\n* [BO] 전시 > 전시연결관리 > 구좌관리 > 구좌목록 그리드 영역\n* 조회 조건에 따라 구좌 목록을 조회한다.\n---\n## 수정번호\n* ```Release v1.05_231204``` : 구좌 관리 최초 개발\n* ```Release``` : 구좌사이트몰맵핑 테이블로 구좌:몰 1:N 개념 추가\n","operationId":"getAccountList","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string"}},{"name":"dpmlNo","in":"query","description":"전시몰번호","schema":{"type":"string"}},{"name":"shopNo","in":"query","description":"매장번호","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"adutInfo","in":"query","description":"구좌 구분 정보","schema":{"type":"string"}},{"name":"adutInfoVal","in":"query","description":"구좌 구분 값","schema":{"type":"string"}},{"name":"dispConrInfo","in":"query","description":"전시코너 구분정보","schema":{"type":"string"}},{"name":"dispConrInfoVal","in":"query","description":"전시코너 값","schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"number"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"구좌 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrDispAdutInfo"}}}},"900":{"description":"구좌 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 구좌 정보 등록 및 수정
> \## 기능설명\
> \* 구좌 정보를 등록 및 수정한다.\
> \---\
> \## 상세설명\
> \* \[BO] 전시 > 전시연결관리 > 구좌관리 > 구좌 등록/수정 팝업\
> \* 입력 파라미터( \_\_\*\_\_: 필수)\
> \- create: \_\_adutId \*, adutNm \*, siteNo \*, dpmlNoList \*, shopNo \*, tmplConrNo \*, useYn \*\_\_\
> \- update: \_\_adutId \*, useYn \*, dpmlNoList \*\_\_\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 구좌 관리 최초 개발\
> \* \`\`\`Release\`\`\` : 템플릿 코너번호 중복체크, 구좌사이트몰맵핑 테이블 저장
````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":{"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account":{"post":{"tags":["구좌 관리"],"summary":"구좌 정보 등록 및 수정","description":"## 기능설명\n* 구좌 정보를 등록 및 수정한다.\n---\n## 상세설명\n* [BO] 전시 > 전시연결관리 > 구좌관리 > 구좌 등록/수정 팝업\n* 입력 파라미터( __*__: 필수)\n - create: __adutId *, adutNm *, siteNo *, dpmlNoList *, shopNo *, tmplConrNo *, useYn *__\n - update: __adutId *, useYn *, dpmlNoList *__\n---\n## 수정번호\n* ```Release v1.05_231204``` : 구좌 관리 최초 개발\n* ```Release``` : 템플릿 코너번호 중복체크, 구좌사이트몰맵핑 테이블 저장\n","operationId":"saveAccount","responses":{"200":{"description":"구좌 관리 등록/수정 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"구좌 관리 등록/수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 구좌 매장 관리 Tree 호출
> \## 기능설명\
> \* 구좌 매장 관리에서 구좌 매장 목록을 Tree 형식으로 호출하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 접근경로 : \[BO] 전시 -> 전시 연결 관리 -> 구좌 매장 관리\
> \
> \* 별도의 구좌 매장 관리 화면에서 구좌 매장 목록을 Tree 형식으로 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 구좌 매장 관리 최초 개발
````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":{"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/shop":{"get":{"tags":["구좌 관리"],"summary":"구좌 매장 관리 Tree 호출","description":"## 기능설명\n* 구좌 매장 관리에서 구좌 매장 목록을 Tree 형식으로 호출하는 API 입니다.\n---\n## 상세설명\n* 접근경로 : [BO] 전시 -> 전시 연결 관리 -> 구좌 매장 관리\n\n* 별도의 구좌 매장 관리 화면에서 구좌 매장 목록을 Tree 형식으로 조회합니다.\n---\n## 수정번호\n* ```Release v1.05_231204``` : 구좌 매장 관리 최초 개발\n","operationId":"getAccountShopList","parameters":[{"name":"dispYn","in":"query","description":"전시여부","schema":{"type":"string"}}],"responses":{"200":{"description":"구좌 매장 관리 TREE 호출 성공","content":{"*/*":{"schema":{"type":"string"}}}},"400":{"description":"구좌 매장 관리 TREE 호출 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 구좌 매장 관리 - 구좌 매장 등록/수정
> \## 기능설명\
> \* 구좌 매장 관리에서 구좌 매장의 정보를 등록 및 수정하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 접근경로 : \[BO] 전시 -> 전시 연결 관리 -> 구좌 매장 관리 -> 구좌 매장 추가\
> \
> \* 등록\
> \* 구좌 매장 추가를 눌러 매장 정보를 기재하고 구좌 매장을 추가 한다.\
> \* 필수정보 : 매장 명, 매장 설명, 전시여부\
> \* 수정\
> \* 수정이 필요한 매장을 선택 후 매장 정보를 수정한다.\
> \* 필수정보 : 매장 명, 전시 여부\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 구좌 매장 관리 최초 개발
````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":{"PrDispShopBase":{"type":"object","description":"전시매장기본","properties":{"shopNo":{"type":"string","description":"매장번호"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispShopNm":{"type":"string","description":"전시매장명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"dispYn":{"type":"string","description":"전시여부"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"prtTypCd":{"type":"string","description":"출력유형코드(DP002)"},"linkUrlAddr":{"type":"string","description":"연결URL주소","readOnly":true},"linkDispNo":{"type":"string","description":"연결전시번호","readOnly":true},"movFrmeCd":{"type":"string","description":"이동프레임코드(DP007)","readOnly":true},"brandNo":{"type":"string","description":"브랜드번호"},"shopDescCont":{"type":"string","description":"매장설명내용"},"dispCtgNm":{"type":"string","description":"전시카테고리이름"},"brandNm":{"type":"string","description":"브랜드명","readOnly":true}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/shop":{"post":{"tags":["구좌 관리"],"summary":"구좌 매장 관리 - 구좌 매장 등록/수정","description":"## 기능설명\n* 구좌 매장 관리에서 구좌 매장의 정보를 등록 및 수정하는 API 입니다.\n---\n## 상세설명\n* 접근경로 : [BO] 전시 -> 전시 연결 관리 -> 구좌 매장 관리 -> 구좌 매장 추가\n\n* 등록\n * 구좌 매장 추가를 눌러 매장 정보를 기재하고 구좌 매장을 추가 한다.\n * 필수정보 : 매장 명, 매장 설명, 전시여부\n* 수정\n * 수정이 필요한 매장을 선택 후 매장 정보를 수정한다.\n * 필수정보 : 매장 명, 전시 여부\n---\n## 수정번호\n* ```Release v1.05_231204``` : 구좌 매장 관리 최초 개발\n","operationId":"saveAccountShop","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrDispShopBase"}}},"required":true},"responses":{"200":{"description":"구좌 매장 저장 성공","content":{"*/*":{"schema":{"type":"string"}}}},"400":{"description":"구좌 매장 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 구좌 상세 정보 조회
> \## 기능설명\
> \* 구좌 상세 정보를 조회한다.\
> \---\
> \## 상세설명\
> \* \[BO] 전시 > 전시연결관리 > 구좌관리 > 구좌 등록/수정 팝업\
> \* 조회 조건에 따라 구좌 상세를 조회한다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release\`\`\` : 구좌 등록/수정 팝업 최초 개발
````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":{"PrDispAdutInfo":{"type":"object","description":"구좌 관리","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"adutId":{"type":"string","description":"구좌ID"},"adutNm":{"type":"string","description":"구좌명"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰 번호"},"dpmlNoList":{"type":"array","description":"몰 번호 목록","items":{"type":"string"}},"dpmlNm":{"type":"string","description":"전시몰명"},"tmplConrNo":{"type":"string","description":"템플릿코너번호"},"conrNo":{"type":"string","description":"코너번호"},"conrNm":{"type":"string","description":"코너명"},"shopNo":{"type":"string","description":"매장번호"},"dispShopNm":{"type":"string","description":"전시매장명"},"dispMediaCd":{"type":"string","description":"전시매체코드(DP018)"},"dispMediaNm":{"type":"string","description":"전시매체코드명(DP018)"},"mappTtl":{"type":"string","description":"매핑타이틀"},"useYn":{"type":"string","description":"사용여부"},"templCornerDispYn":{"type":"string","description":"템플릿코너전시여부"},"shopDispYn":{"type":"string","description":"매장전시여부"},"updateFlag":{"type":"string","description":"수정 상태 여부"},"totalCount":{"type":"integer","format":"int32","description":"총 갯수"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/{adutId}":{"get":{"tags":["구좌 관리"],"summary":"구좌 상세 정보 조회","description":"## 기능설명\n* 구좌 상세 정보를 조회한다.\n---\n## 상세설명\n* [BO] 전시 > 전시연결관리 > 구좌관리 > 구좌 등록/수정 팝업\n* 조회 조건에 따라 구좌 상세를 조회한다.\n---\n## 수정번호\n* ```Release``` : 구좌 등록/수정 팝업 최초 개발\n","operationId":"getAccountDetail","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string"}},{"name":"adutId","in":"path","description":"구좌ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"구좌 상세 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrDispAdutInfo"}}}},"900":{"description":"구좌 상세 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 구좌에 연결된 템플릿코너번호 목록 조회
> \## 기능설명\
> \* 구좌에 연결된 템플릿코너번호 목록을 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 전시 > 전시연결관리 > 서비스별 구좌 관리\
> \* 구좌에 연결된 템플릿코너번호 목록을 조회합니다.
```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":{"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/tmplConrNo":{"get":{"tags":["구좌 관리"],"summary":"구좌에 연결된 템플릿코너번호 목록 조회","description":"## 기능설명\n* 구좌에 연결된 템플릿코너번호 목록을 조회하는 API입니다.\n---\n## 상세설명\n* [BO] 전시 > 전시연결관리 > 서비스별 구좌 관리\n* 구좌에 연결된 템플릿코너번호 목록을 조회합니다.\n","operationId":"getMappedTmplConrNoList","parameters":[{"name":"tmplConrNoList","in":"query","description":"템플릿코너번호 목록","required":true,"schema":{"type":"array"}}],"responses":{"200":{"description":"구좌에 연결된 템플릿코너번호 목록 조회 조회 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"구좌에 연결된 템플릿코너번호 목록 조회 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```