# 사이트 전시몰 ## 사이트 조회 > \## 기능설명\ > \* 사이트 정보 단건을 조회하는 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"}}}}}} ```` --- # 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/display-api/undefined-1.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.