> 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-3.md).
# 기획전
## 기획전 조회
> \## 기능설명\
> \* 해당 사이트,몰 기준 기획전 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 사이트, 몰 기준으로 기획전 정보를 조회합니다.\
> \* 기획전번호가 있을경우 기획전 번호에 해당하는 정보들을 조회합니다.\
> \* 브랜드 번호, 정렬타입(최신순, 마감순), 진행여부에 따라 기획전 정보를 조회합니다.\
> \* 회원등급 및 임직원 여부에 따른 권한 체크를 통해 기획전 노출이 제한됩니다.\
> \---\
> \## 특이사항\
> \* 권한 체크 기준은 And 기준으로 ① 전시회원등급(GREEN), ② 임직원전용에 체크한 경우 해당 기획전은 ‘임직원 + GREEN에게만 노출됩니다.\
> \* 전체 미 체크 시 비회원을 포함한 모든 사용자에게 노출합니다.
```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/plan/planList":{"get":{"tags":["기획전"],"summary":"기획전 조회","description":"## 기능설명\n* 해당 사이트,몰 기준 기획전 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 사이트, 몰 기준으로 기획전 정보를 조회합니다.\n* 기획전번호가 있을경우 기획전 번호에 해당하는 정보들을 조회합니다.\n* 브랜드 번호, 정렬타입(최신순, 마감순), 진행여부에 따라 기획전 정보를 조회합니다.\n* 회원등급 및 임직원 여부에 따른 권한 체크를 통해 기획전 노출이 제한됩니다.\n---\n## 특이사항\n* 권한 체크 기준은 And 기준으로 ① 전시회원등급(GREEN), ② 임직원전용에 체크한 경우 해당 기획전은 ‘임직원 + GREEN에게만 노출됩니다.\n * 전체 미 체크 시 비회원을 포함한 모든 사용자에게 노출합니다.\n","operationId":"getPlanList","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"string","description":"string"}},{"name":"sortType","in":"query","description":"정렬타입","schema":{"type":"string","description":"string"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"progressYn","in":"query","description":"진행여부","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"기획전 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanModel"}}}},"400":{"description":"기획전 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanModel":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int64","description":"총 개수"},"planInfoList":{"type":"array","description":"기획전 정보 리스트","items":{"$ref":"#/components/schemas/PlanInfo"}}}},"PlanInfo":{"type":"object","description":"가획전 정보 DTO","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"tmplNo":{"type":"string","description":"템플릿번호"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"pcTopYn":{"type":"string","description":"PC상단고정여부"},"dispSeq":{"type":"string","description":"전시순서"},"totalCount":{"type":"string","description":"총 갯수"},"startDate":{"type":"string","format":"date-time","description":"시작 날짜"},"endDate":{"type":"string","format":"date-time","description":"종료 날짜"},"wishContYn":{"type":"string","description":"찜여부"},"imageList":{"type":"array","description":"기획전 이미지 리스트","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanImageContent":{"type":"object","description":"가획전 이미지 정보 DTO","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"contGbCd":{"type":"string","description":"컨텐츠구분코드(DP026)"},"bnrImgPathNm":{"type":"string","description":"이미지경로"},"bnrImgAltCont":{"type":"string","description":"이미지 대체텍스트"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 기획전 조회
> \## 기능설명\
> \* 해당 사이트,몰 기준 기획전 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 사이트, 몰 기준으로 기획전 정보를 조회합니다.\
> \* 기획전번호가 있을경우 기획전 번호에 해당하는 정보들을 조회합니다.\
> \* 브랜드 번호, 정렬타입(최신순, 마감순), 진행여부에 따라 기획전 정보를 조회합니다.\
> \* 회원등급 및 임직원 여부에 따른 권한 체크를 통해 기획전 노출이 제한됩니다.\
> \---\
> \## 특이사항\
> \* 권한 체크 기준은 And 기준으로 ① 전시회원등급(GREEN), ② 임직원전용에 체크한 경우 해당 기획전은 ‘임직원 + GREEN에게만 노출됩니다.\
> \* 전체 미 체크 시 비회원을 포함한 모든 사용자에게 노출합니다.
```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/plan/planWishList":{"get":{"tags":["기획전"],"summary":"기획전 조회","description":"## 기능설명\n* 해당 사이트,몰 기준 기획전 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 사이트, 몰 기준으로 기획전 정보를 조회합니다.\n* 기획전번호가 있을경우 기획전 번호에 해당하는 정보들을 조회합니다.\n* 브랜드 번호, 정렬타입(최신순, 마감순), 진행여부에 따라 기획전 정보를 조회합니다.\n* 회원등급 및 임직원 여부에 따른 권한 체크를 통해 기획전 노출이 제한됩니다.\n---\n## 특이사항\n* 권한 체크 기준은 And 기준으로 ① 전시회원등급(GREEN), ② 임직원전용에 체크한 경우 해당 기획전은 ‘임직원 + GREEN에게만 노출됩니다.\n * 전체 미 체크 시 비회원을 포함한 모든 사용자에게 노출합니다.\n","operationId":"getPlanList_1","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"string","description":"string"}},{"name":"sortType","in":"query","description":"정렬타입","schema":{"type":"string","description":"string"}},{"name":"pageNo","in":"query","description":"호출 페이지 번호","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"호출 페이지 사이즈","schema":{"type":"string","description":"integer"}},{"name":"progressYn","in":"query","description":"진행여부","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"기획전 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanModel"}}}},"400":{"description":"기획전 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanModel":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int64","description":"총 개수"},"planInfoList":{"type":"array","description":"기획전 정보 리스트","items":{"$ref":"#/components/schemas/PlanInfo"}}}},"PlanInfo":{"type":"object","description":"가획전 정보 DTO","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"tmplNo":{"type":"string","description":"템플릿번호"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"pcTopYn":{"type":"string","description":"PC상단고정여부"},"dispSeq":{"type":"string","description":"전시순서"},"totalCount":{"type":"string","description":"총 갯수"},"startDate":{"type":"string","format":"date-time","description":"시작 날짜"},"endDate":{"type":"string","format":"date-time","description":"종료 날짜"},"wishContYn":{"type":"string","description":"찜여부"},"imageList":{"type":"array","description":"기획전 이미지 리스트","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanImageContent":{"type":"object","description":"가획전 이미지 정보 DTO","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"contGbCd":{"type":"string","description":"컨텐츠구분코드(DP026)"},"bnrImgPathNm":{"type":"string","description":"이미지경로"},"bnrImgAltCont":{"type":"string","description":"이미지 대체텍스트"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 기획전 구분자별 상품 조회
> \## 기능설명\
> \* 해당 기획전 번호와 구분자 번호를 통해 구분자별 상품을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 구분자 번호 없을 시 전체 구분자 정보를 조회합니다.\
> \* 기획전 구분자는 전시순서, 구분자번호 순으로 노출됩니다.\
> \* 상품정렬코드를 통해 상품에 대한 전시순서를 설정할 수 있습니다.(default: 10)\
> \* 해당 구분자에 상품이 없을경우 빈값으로 리턴됩니다.\
> \---\
> \## 특이사항\
> \* BO에서 기획전 미리보기를 통해 언어코드를 설정할 수 있습니다.(dataLangCd)\
> \---\
> \## 코드정리\
> \* \`\`\`상품정렬코드\`\`\` : 10:신상순,20:판매순,30:고가순,40:저가순,50:상품평순
````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/plan/planGoodsInfo":{"get":{"tags":["기획전"],"summary":"기획전 구분자별 상품 조회","description":"## 기능설명\n* 해당 기획전 번호와 구분자 번호를 통해 구분자별 상품을 조회하는 API 입니다.\n---\n## 상세설명\n* 구분자 번호 없을 시 전체 구분자 정보를 조회합니다.\n * 기획전 구분자는 전시순서, 구분자번호 순으로 노출됩니다.\n* 상품정렬코드를 통해 상품에 대한 전시순서를 설정할 수 있습니다.(default: 10)\n* 해당 구분자에 상품이 없을경우 빈값으로 리턴됩니다.\n---\n## 특이사항\n* BO에서 기획전 미리보기를 통해 언어코드를 설정할 수 있습니다.(dataLangCd)\n---\n## 코드정리\n* ```상품정렬코드``` : 10:신상순,20:판매순,30:고가순,40:저가순,50:상품평순\n","operationId":"getPlanGoodsInfo","parameters":[{"name":"mkdpNo","in":"query","description":"기획전번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"divobjNo","in":"query","description":"구분자번호","schema":{"type":"string","description":"string"}},{"name":"sort","in":"query","description":"상품정렬코드","schema":{"type":"string","description":"string"}},{"name":"dataLangCd","in":"query","description":"미리보기 langCd","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"기획전 구분자별 상품 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanDivObjInfo"}}}},"400":{"description":"기획전 구분자별 상품 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanDivObjInfo":{"type":"object","description":"가획전 구분자 DTO","properties":{"divobjNo":{"type":"string","description":"구분자번호"},"divobjNm":{"type":"string","description":"구분자명"},"divobjGbCd":{"type":"string","description":"구분자구분코드"},"dispSeq":{"type":"string","description":"전시순서"},"tmplNo":{"type":"string","description":"전시템플릿번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"구분자이미지경로"},"bnrImgAltCont":{"type":"string","description":"구분자이미지대체텍스트"},"htmlFileCont":{"type":"string","description":"HTML파일컨텐츠"},"cpnDnldYn":{"type":"string","description":"쿠폰다운여부"},"cpnNo":{"type":"string","description":"쿠폰번호"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsList":{"type":"array","description":"기힉전상품리스트","items":{"$ref":"#/components/schemas/Goods"}}}},"Goods":{"type":"object","description":"상품 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"entrNo":{"type":"string","description":"협력사번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약상품"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:0, 15:15"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"prcHistStrDtm":{"type":"string","format":"date-time","description":"가격이력시작일시"},"prcHistEndDtm":{"type":"string","format":"date-time","description":"가격이력종료일시"},"rcntSalePrc":{"type":"integer","format":"int64","description":"최근판매가"},"salePrc":{"type":"integer","format":"int64","description":"판매가"},"aplyPrc":{"type":"integer","format":"int64","description":"적용가(전시가격)"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"goodsImmedDcCpnNo":{"type":"string","description":"상품즉시할인쿠폰번호"},"goodsImmedDcAplyStrDtm":{"type":"string","format":"date-time","description":"상품즉시할인적용시작일시"},"goodsImmedDcAplyEndDtm":{"type":"string","format":"date-time","description":"상품즉시할인적용종료일시"},"goodsRepImgContSn":{"type":"string","description":"상품대표이미지컨텐츠일련번호"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"rservStrDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rservEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"goodsRevCnt":{"type":"string","description":"상품리뷰수"},"goodsRevHlpfulCnt":{"type":"string","description":"상품리뷰도움돼요수"},"goodsRevStarscrAvgVal":{"type":"number","format":"double","description":"상품리뷰별점평균값"},"fixamtFxrtGbCd":{"type":"string","description":"상품즉시정액정율구분코드(MK005)"},"dcRateAmt":{"type":"integer","format":"int64","description":"상품즉시할인율금액"},"dcRate":{"type":"integer","format":"int64","description":"상품할인율"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsRepImgPathNm":{"type":"string","description":"대표이미지파일 경로"},"trnfTextCont":{"type":"string","description":"대표이미지 대체 텍스트"},"adlCertiYn":{"type":"string","description":"성인인증여부"},"iconList":{"type":"array","description":"아이콘정보","items":{"type":"string"}},"prcTimeDealYn":{"type":"string","description":"타임딜여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
````
## 기획전 상세 조회
> \## 기능설명\
> \* 기획전 번호를 통해 기본정보,구분자 정보 및 해당 상품정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 기획전 기본정보, 구분자 리스트 및 해당 상품리스트, 최근 기획전리스트, 기획전 이미지리스트를 조회합니다.\
> \* 구분자별 상품은 설정한 전시순서순으로 노출됩니다.\
> \* 해당 구분자에 상품이 없을경우 빈값으로 리턴됩니다.\
> \* 회원등급 및 임직원 여부에 따른 권한 체크를 통해 기획전 노출이 제한됩니다.\
> \---\
> \## 특이사항\
> \* 권한 체크 기준은 And 기준으로 ① 전시회원등급(GREEN), ② 임직원전용에 체크한 경우 해당 기획전은 ‘임직원 + GREEN에게만 노출됩니다.\
> \* 전체 미 체크 시 비회원을 포함한 모든 사용자에게 노출합니다.\
> \* previewDate에 값이 있을경우 회원등급 및 전시여부에 상관없이 노출됩니다.\
> \* BO에서 기획전 미리보기를 통해 언어코드를 설정할 수 있습니다.(dataLangCd)\
> \---\
> \## 검증내용\
> \* 에러코드 1003 : 기획전 데이터 없음\
> \* 에러코드 7010 : 기획전 로그인 필요\
> \* 에러코드 7020 : 기획전 회원등급 제한
```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/plan/planDetail/{mkdpNo}":{"get":{"tags":["기획전"],"summary":"기획전 상세 조회","description":"## 기능설명\n* 기획전 번호를 통해 기본정보,구분자 정보 및 해당 상품정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 기획전 기본정보, 구분자 리스트 및 해당 상품리스트, 최근 기획전리스트, 기획전 이미지리스트를 조회합니다.\n* 구분자별 상품은 설정한 전시순서순으로 노출됩니다.\n* 해당 구분자에 상품이 없을경우 빈값으로 리턴됩니다.\n* 회원등급 및 임직원 여부에 따른 권한 체크를 통해 기획전 노출이 제한됩니다.\n---\n## 특이사항\n* 권한 체크 기준은 And 기준으로 ① 전시회원등급(GREEN), ② 임직원전용에 체크한 경우 해당 기획전은 ‘임직원 + GREEN에게만 노출됩니다.\n * 전체 미 체크 시 비회원을 포함한 모든 사용자에게 노출합니다.\n* previewDate에 값이 있을경우 회원등급 및 전시여부에 상관없이 노출됩니다.\n* BO에서 기획전 미리보기를 통해 언어코드를 설정할 수 있습니다.(dataLangCd)\n---\n## 검증내용\n* 에러코드 1003 : 기획전 데이터 없음\n* 에러코드 7010 : 기획전 로그인 필요\n* 에러코드 7020 : 기획전 회원등급 제한\n","operationId":"getPlanDetailInfo","parameters":[{"name":"mkdpNo","in":"path","description":"기획전번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"previewDate","in":"query","description":"미리보기","schema":{"type":"string","description":"localDate"}},{"name":"dataLangCd","in":"query","description":"미리보기 langCd","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"기획전 상세 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanDetailInfo"}}}},"1003":{"description":"기획전 데이터 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"7010":{"description":"회원 로그인 필요","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"7020":{"description":"기획전 회원등급 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanDetailInfo":{"type":"object","description":"가획전 상세 Response DTO","properties":{"resultCd":{"type":"string","description":"에러결과코드"},"resultMsg":{"type":"string","description":"에러결과메시지"},"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"tmplNo":{"type":"string","description":"템플릿번호"},"tmplFileNm":{"type":"string","description":"템플릿파일명"},"startDate":{"type":"string","format":"date-time","description":"시작날짜"},"endDate":{"type":"string","format":"date-time","description":"종료날짜"},"introCont":{"type":"string","description":"소개글"},"briefDescription":{"type":"string","description":"간략설명"},"titleHtml":{"type":"string","description":"타이틀HTML"},"titleHtmlPc":{"type":"string","description":"PC타이틀HTML"},"footerContents":{"type":"string","description":"푸터파일내용"},"wishContYn":{"type":"string","description":"찜여부"},"pcTopYn":{"type":"string","description":"상단고정여부"},"staffYn":{"type":"string","description":"임직원여부"},"planDivObjList":{"type":"array","description":"기획전 구분자 리스트","items":{"$ref":"#/components/schemas/PlanDivObjInfo"}},"recentPlanList":{"type":"array","description":"최근 기획전 리스트","items":{"$ref":"#/components/schemas/PlanInfo"}},"titleImgMovList":{"type":"array","description":"기획전 이미지 리스트 ","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanDivObjInfo":{"type":"object","description":"가획전 구분자 DTO","properties":{"divobjNo":{"type":"string","description":"구분자번호"},"divobjNm":{"type":"string","description":"구분자명"},"divobjGbCd":{"type":"string","description":"구분자구분코드"},"dispSeq":{"type":"string","description":"전시순서"},"tmplNo":{"type":"string","description":"전시템플릿번호"},"textDivobjNm":{"type":"string","description":"텍스트구분자명"},"bnrImgPathNm":{"type":"string","description":"구분자이미지경로"},"bnrImgAltCont":{"type":"string","description":"구분자이미지대체텍스트"},"htmlFileCont":{"type":"string","description":"HTML파일컨텐츠"},"cpnDnldYn":{"type":"string","description":"쿠폰다운여부"},"cpnNo":{"type":"string","description":"쿠폰번호"},"cpnBnrImgPathNm":{"type":"string","description":"쿠폰배너경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsList":{"type":"array","description":"기힉전상품리스트","items":{"$ref":"#/components/schemas/Goods"}}}},"Goods":{"type":"object","description":"상품 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"entrNo":{"type":"string","description":"협력사번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약상품"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:0, 15:15"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"prcHistStrDtm":{"type":"string","format":"date-time","description":"가격이력시작일시"},"prcHistEndDtm":{"type":"string","format":"date-time","description":"가격이력종료일시"},"rcntSalePrc":{"type":"integer","format":"int64","description":"최근판매가"},"salePrc":{"type":"integer","format":"int64","description":"판매가"},"aplyPrc":{"type":"integer","format":"int64","description":"적용가(전시가격)"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"goodsImmedDcCpnNo":{"type":"string","description":"상품즉시할인쿠폰번호"},"goodsImmedDcAplyStrDtm":{"type":"string","format":"date-time","description":"상품즉시할인적용시작일시"},"goodsImmedDcAplyEndDtm":{"type":"string","format":"date-time","description":"상품즉시할인적용종료일시"},"goodsRepImgContSn":{"type":"string","description":"상품대표이미지컨텐츠일련번호"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"rservStrDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rservEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"goodsRevCnt":{"type":"string","description":"상품리뷰수"},"goodsRevHlpfulCnt":{"type":"string","description":"상품리뷰도움돼요수"},"goodsRevStarscrAvgVal":{"type":"number","format":"double","description":"상품리뷰별점평균값"},"fixamtFxrtGbCd":{"type":"string","description":"상품즉시정액정율구분코드(MK005)"},"dcRateAmt":{"type":"integer","format":"int64","description":"상품즉시할인율금액"},"dcRate":{"type":"integer","format":"int64","description":"상품할인율"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsRepImgPathNm":{"type":"string","description":"대표이미지파일 경로"},"trnfTextCont":{"type":"string","description":"대표이미지 대체 텍스트"},"adlCertiYn":{"type":"string","description":"성인인증여부"},"iconList":{"type":"array","description":"아이콘정보","items":{"type":"string"}},"prcTimeDealYn":{"type":"string","description":"타임딜여부"}}},"PlanInfo":{"type":"object","description":"가획전 정보 DTO","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"tmplNo":{"type":"string","description":"템플릿번호"},"brefDesc":{"type":"string","description":"간략설명"},"introConts":{"type":"string","description":"소개글"},"pcTopYn":{"type":"string","description":"PC상단고정여부"},"dispSeq":{"type":"string","description":"전시순서"},"totalCount":{"type":"string","description":"총 갯수"},"startDate":{"type":"string","format":"date-time","description":"시작 날짜"},"endDate":{"type":"string","format":"date-time","description":"종료 날짜"},"wishContYn":{"type":"string","description":"찜여부"},"imageList":{"type":"array","description":"기획전 이미지 리스트","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanImageContent":{"type":"object","description":"가획전 이미지 정보 DTO","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"imgTypCd":{"type":"string","description":"이미지유형코드(DP013)"},"contGbCd":{"type":"string","description":"컨텐츠구분코드(DP026)"},"bnrImgPathNm":{"type":"string","description":"이미지경로"},"bnrImgAltCont":{"type":"string","description":"이미지 대체텍스트"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 기획전 그룹 목록 조회
> \## 기능설명\
> \* 해당 사이트,몰 기준 기획전 그룹 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 쿠키값에 사이트번호,몰번호를 받아 기획전 그룹 목록을 조회합니다.\
> \* 사용 여부가 Y이고 현재날짜 기준으로 전시 기간에 해당하는 정보만 조회합니다.\
> \* 기획전 그룹 목록은 전시순서 오름차순으로 노출됩니다.
```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/plan/group":{"get":{"tags":["기획전"],"summary":"기획전 그룹 목록 조회","description":"## 기능설명\n* 해당 사이트,몰 기준 기획전 그룹 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 쿠키값에 사이트번호,몰번호를 받아 기획전 그룹 목록을 조회합니다.\n* 사용 여부가 Y이고 현재날짜 기준으로 전시 기간에 해당하는 정보만 조회합니다.\n* 기획전 그룹 목록은 전시순서 오름차순으로 노출됩니다.\n","operationId":"getPlanGroupList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"기획전 그룹 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanGroupInfo"}}}},"400":{"description":"기획전 그룹 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanGroupInfo":{"type":"object","description":"기획전그룹 정보 DTO","properties":{"dispGrpNo":{"type":"string","description":"전시그룹번호"},"dispGrpNm":{"type":"string","description":"전시그룹명"},"dispSeq":{"type":"string","description":"전시순서"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 기획전 브랜드 조회
> \## 기능설명\
> \* 해당 사이트,몰 기준 기획전 브랜드 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 쿠키값에 사이트번호,몰번호를 받아 기획전 브랜드 목록을 조회합니다.
```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/plan/brand":{"get":{"tags":["기획전"],"summary":"기획전 브랜드 조회","description":"## 기능설명\n* 해당 사이트,몰 기준 기획전 브랜드 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 쿠키값에 사이트번호,몰번호를 받아 기획전 브랜드 목록을 조회합니다.\n","operationId":"getPlanBrandList","parameters":[{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"기획전 브랜드 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brand"}}}},"400":{"description":"기획전 브랜드 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"Brand":{"type":"object","description":"브랜드 DTO","properties":{"brandNo":{"type":"string","description":"브랜드번호"},"useYn":{"type":"string","description":"사용여부"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"brandNm":{"type":"string","description":"브랜드명"},"brandDescCmt":{"type":"string","description":"브랜드설명"},"schKwdNm":{"type":"string","description":"검색키워드명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```