# 구좌 관리
## 구좌 목록 조회
> \## 기능설명\
> \* 전체 구좌 목록을 조회한다.\
> \---\
> \## 상세설명\
> \* \[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"}}}}}}}}}
```
---
# 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/display-bo-api/undefined-12.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.