> 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/display-api/undefined-1.md).
# 사이트 전시몰
## 사이트 조회
> \## 기능설명\
> \* 사이트 정보 단건을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 쿠키값에 사이트번호를 받아 해당 사이트 정보를 조회한다. (default : 1)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/site":{"get":{"tags":["사이트 전시몰"],"summary":"사이트 조회","description":"## 기능설명\n* 사이트 정보 단건을 조회하는 API 입니다.\n---\n## 상세설명\n* 쿠키값에 사이트번호를 받아 해당 사이트 정보를 조회한다. (default : 1)\n","operationId":"getSiteInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"사이트 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SiteInfo"}}}},"400":{"description":"사이트 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"SiteInfo":{"type":"object","description":"사이트 정보 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"trdStrtDt":{"type":"string","description":"거래시작일자"},"trdEndDt":{"type":"string","description":"거래종료일자"},"siteDom":{"type":"string","description":"사이트도메인"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 사이트 팝업목록 조회
> \## 기능설명\
> \* 해당 사이트의 팝업 정보 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 채널상세번호를 입력하지 않았을 경우에는 default 1000001이 설정됩니다.\
> \* 팝업 기간에 해당되는 팝업만 노출되고 우선순위 순으로 노출됩니다.\
> \* 우선순위가 같을경우 시스템 등록순, 시스템 수정순으로 노출됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/site/popupList":{"get":{"tags":["사이트 전시몰"],"summary":"사이트 팝업목록 조회","description":"## 기능설명\n* 해당 사이트의 팝업 정보 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 채널상세번호를 입력하지 않았을 경우에는 default 1000001이 설정됩니다.\n* 팝업 기간에 해당되는 팝업만 노출되고 우선순위 순으로 노출됩니다.\n * 우선순위가 같을경우 시스템 등록순, 시스템 수정순으로 노출됩니다.\n","operationId":"getSitePopupList","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP015)","required":true,"schema":{"type":"string","description":"string"}},{"name":"popupTgtScrnCd","in":"query","description":"팝업대상화면코드(DP016)","required":true,"schema":{"type":"string","description":"string"}},{"name":"dispMediaDtlCd","in":"query","description":"전시매체상코드","schema":{"type":"string","description":"string"}},{"name":"chlDtlNo","in":"query","description":"채널상세번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"prtTypCd","in":"query","description":"팝업출력유형코드(DP017)","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"팝업리스트 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SitePopupInfo"}}}},"400":{"description":"팝업리스트 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"SitePopupInfo":{"type":"object","description":"사이트 팝업 정보 DTO","properties":{"popupNo":{"type":"string","description":"팝업번호"},"popupNm":{"type":"string","description":"팝업명"},"popupTypCd":{"type":"string","description":"팝업유형코드(DP014 01:정보제공형팝업, 02:앱연결팝업,03:쿠폰다운로드팝업)"},"prtTypCd":{"type":"string","description":"팝업출력유형코드(DP017 01:전체화면, 02:일부화면)"},"popupContGbCd":{"type":"string","description":"팝업내용구분코드(DP029 01:이미지형, 02:HTML)"},"popupLink":{"type":"string","description":"팝업링크"},"popupImgPathNm":{"type":"string","description":"팝업이미지경로명 (전시매체 MOBILE일 경우 필수)"},"popupCont":{"type":"string","description":"팝업내용 (팝업내용구분코드 HTML일 경우 필수)"},"popupSzWdt":{"type":"string","description":"팝업사이즈넓이 (전시매체 PC일 경우 필수)"},"popupSzHigh":{"type":"string","description":"팝업사이즈높이 (전시매체 PC일 경우 필수)"},"popupLocLeft":{"type":"string","description":"팝업위치LEFT (전시매체 PC일 경우 필수)"},"popupLocTop":{"type":"string","description":"팝업위치 (전시매체 PC일 경우 필수)"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"chlLinkInfo":{"type":"string","description":"채널연결정보 (팝업유형코드가 02인 경우 앱 트래킹코드, 03인 경우 쿠폰번호로 사용)"},"prioRnk":{"type":"string","description":"우선순위"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 사이트 약관 목록 조회
> \## 기능설명\
> \* 해당 사이트의 약관 정보와 과거 약관적용 날짜 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 현재 날짜 기준 해당 약관 정보와 과거 약관 정보 날짜 목록을 조회합니다.\
> \* 현재 날짜에 적용되는 약관이 2개이상 존재하면 적용 시작날짜가 가장 최근 약관 1건이 조회됩니다.\
> \* 과거 약관 적용 날짜 목록은 최근순으로 노출됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/site/policyList":{"get":{"tags":["사이트 전시몰"],"summary":"사이트 약관 목록 조회","description":"## 기능설명\n* 해당 사이트의 약관 정보와 과거 약관적용 날짜 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 현재 날짜 기준 해당 약관 정보와 과거 약관 정보 날짜 목록을 조회합니다.\n * 현재 날짜에 적용되는 약관이 2개이상 존재하면 적용 시작날짜가 가장 최근 약관 1건이 조회됩니다.\n * 과거 약관 적용 날짜 목록은 최근순으로 노출됩니다.\n","operationId":"getPolicyInfo","parameters":[{"name":"siteNo","in":"query","description":"사이트번호 (x2bee.com : 1)","required":true,"schema":{"type":"string","description":"string"}},{"name":"agmtPolcCd","in":"query","description":"약관정책코드(CH005)","required":true,"schema":{"type":"string","description":"string"}},{"name":"aplyStrDt","in":"query","description":"적용시작일자","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"약관 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TermsPolicy"}}}},"400":{"description":"약관 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"TermsPolicy":{"type":"object","description":"약관 정보 DTO","properties":{"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"siteNo":{"type":"string","description":"사이트번호"},"cmAgmtPolcGbCd":{"type":"string","description":"공통약관전챙구분코드(CH010)"},"agmtPolcCd":{"type":"string","description":"약관정책코드(CH005)"},"agmtPolcNm":{"type":"string","description":"약관정책명"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"title":{"type":"string","description":"제목"},"wrdCont":{"type":"string","description":"문구내용"},"langCd":{"type":"string","description":"언어코드(CM009)"},"applyDateList":{"type":"array","description":"적용 날짜 리스트","items":{"$ref":"#/components/schemas/TermsPolicyDate"}}}},"TermsPolicyDate":{"type":"object","properties":{"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"agmtPolcCd":{"type":"string","description":"약관정책코드"},"aplyStrDt":{"type":"string","description":"적용시행일자"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 전시몰 목록 조회
> \## 기능설명\
> \* 해당 사이트에 속한 몰 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 쿠키값에 사이트번호를 받아 해당 몰 정보 목록을 조회한다. (default : 1)\
> \* 몰 정보는 전시 순서 순으로 노출됩니다.\
> \---\
> \### 코드정리\
> \* \`\`\` 전시여부 \`\`\` : Y,N
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/mall":{"get":{"tags":["사이트 전시몰"],"summary":"전시몰 목록 조회","description":"## 기능설명\n* 해당 사이트에 속한 몰 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 쿠키값에 사이트번호를 받아 해당 몰 정보 목록을 조회한다. (default : 1)\n* 몰 정보는 전시 순서 순으로 노출됩니다.\n---\n### 코드정리\n* ``` 전시여부 ``` : Y,N\n","operationId":"getMallInfo","parameters":[{"name":"siteNo","in":"query","description":"사이트번호 (x2bee.com : 1)","required":true},{"name":"dispYn","in":"query","description":"전시여부 (전시 : Y, 비전시 : N)","required":true},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"몰 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MallBase"}}}},"400":{"description":"몰 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"MallBase":{"type":"object","description":"몰 정보 DTO","properties":{"dpmlNo":{"type":"string","description":"몰번호"},"dpmlNm":{"type":"string","description":"몰명"},"linkUrlAddr":{"type":"string","description":"링크URL주소"},"movFrmeCd":{"type":"string","description":"이동프레임코드(DP007)"},"dispSeq":{"type":"string","description":"전시순서"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
````
## 전시몰 단건 조회
> \## 기능설명\
> \* 몰 정보 단건을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 몰 번호를 받아 해당 몰 정보를 조회한다.\
> \---\
> \### 코드정리\
> \* \`\`\` 몰번호 \`\`\` : ex)10001
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/mall/defaultShop":{"get":{"tags":["사이트 전시몰"],"summary":"전시몰 단건 조회","description":"## 기능설명\n* 몰 정보 단건을 조회하는 API 입니다.\n---\n## 상세설명\n* 몰 번호를 받아 해당 몰 정보를 조회한다.\n---\n### 코드정리\n* ``` 몰번호 ``` : ex)10001\n","operationId":"getDefaultShopInfo","parameters":[{"name":"mallNo","in":"query","description":"몰번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"몰 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MallBase"}}}},"400":{"description":"몰 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"MallBase":{"type":"object","description":"몰 정보 DTO","properties":{"dpmlNo":{"type":"string","description":"몰번호"},"dpmlNm":{"type":"string","description":"몰명"},"linkUrlAddr":{"type":"string","description":"링크URL주소"},"movFrmeCd":{"type":"string","description":"이동프레임코드(DP007)"},"dispSeq":{"type":"string","description":"전시순서"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
````