# 기획전
## 기획전 조회
> \## 기능설명\
> \* 해당 사이트,몰 기준 기획전 정보를 조회하는 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"}}}}}}
```
---
# 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-3.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.