> 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-4.md).
# 전시카테고리
## 전시 아이콘 목록 조회
> \## 기능설명\
> \* 전시 아이콘 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 사이트번호 기준으로 전시 아이콘 정보 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.03\_231106\`\`\` : 아이콘(뱃지) 설정
````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/icon":{"get":{"tags":["전시카테고리"],"summary":"전시 아이콘 목록 조회","description":"## 기능설명\n* 전시 아이콘 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 사이트번호 기준으로 전시 아이콘 정보 목록을 조회합니다.\n---\n## 수정번호\n* ```Release v1.03_231106``` : 아이콘(뱃지) 설정\n","operationId":"getIconList","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","required":true,"schema":{"type":"string"}},{"name":"dispMediaCd","in":"query","description":"전시매체코드(DP018)","required":true,"schema":{"type":"string"}},{"name":"iconTypCd","in":"query","description":"아이콘유형코드(DP001)","schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"전시 아이콘 목록 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IconInfo"}}}}}}}},"components":{"schemas":{"IconInfo":{"type":"object","description":"아이콘 DTO","properties":{"siteNo":{"type":"string","description":"사이트"},"dispIconNo":{"type":"string","description":"아이콘번호"},"iconNm":{"type":"string","description":"아이콘명"},"iconTypCd":{"type":"string","description":"아이콘유형코드"},"pcIconFileNm":{"type":"string","description":"PC아이콘파일명"},"pcIconPathNm":{"type":"string","description":"PC아이콘경로명"},"moIconFileNm":{"type":"string","description":"MO아이콘파일명"},"moIconPathNm":{"type":"string","description":"Mo아이콘경로명"}}}}}}
````
## 전시상품 조회
> \## 기능설명\
> \* 상품 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 전시카테고리번호 전달 시 전시카테고리 상품 상세 정보 목록을 조회합니다.\
> \* 상품번호 전달 시 해당 상품의 상세 정보 목록을 조회합니다.\
> \* 페이지번호, 페이지사이즈 전달 시 전체 개수(totalCount)를 함께 조회합니다.
```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/goods":{"get":{"tags":["전시카테고리"],"summary":"전시상품 조회","description":"## 기능설명\n* 상품 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 전시카테고리번호 전달 시 전시카테고리 상품 상세 정보 목록을 조회합니다.\n* 상품번호 전달 시 해당 상품의 상세 정보 목록을 조회합니다.\n* 페이지번호, 페이지사이즈 전달 시 전체 개수(totalCount)를 함께 조회합니다.\n","operationId":"getGoodsList","parameters":[{"name":"goodsNoArr","in":"query","description":"상품번호 리스트","schema":{"type":"string"}},{"name":"dispCtgNo","in":"query","description":"카테고리 번호","schema":{"type":"string"}},{"name":"pageNo","in":"query","description":"페이지번호","schema":{"type":"integer"}},{"name":"pageSize","in":"query","description":"페이지사이즈","schema":{"type":"integer"}},{"name":"sort","in":"query","description":"정렬코드","schema":{"type":"string"}},{"name":"saleStatCds","in":"query","description":"판매상태코드(PR005)","schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"전시상품 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Goods"}}}}}}}},"components":{"schemas":{"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":"타임딜여부"}}}}}}
```
## 전시 카테고리 목록 조회
> \## 기능설명\
> \* 전체 전시 카테고리 정보 또는 브랜드 전시카테고리 정보를 조회한다.\
> \---\
> \## 상세설명\
> \* 전체 전시 카테고리 정보\
> \* 파라미터가 없다면 전체 전시 카테고리 정보를 subCategoryList를 이용해 대/중/소/세 계층적으로 조회한다.\
> \* 브랜드 전시 카테고리 정보\
> \* 브랜드 번호(brandNo)를 파라미터로 받는 경우 해당 브랜드 상품들이 속해 있는 전시 카테고리 정보를 subCategoryList를 이용해 대/중/소/세 계층적으로 조회한다.
```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/displayCategory":{"get":{"tags":["전시카테고리"],"summary":"전시 카테고리 목록 조회","description":"## 기능설명\n* 전체 전시 카테고리 정보 또는 브랜드 전시카테고리 정보를 조회한다.\n---\n## 상세설명\n* 전체 전시 카테고리 정보\n * 파라미터가 없다면 전체 전시 카테고리 정보를 subCategoryList를 이용해 대/중/소/세 계층적으로 조회한다.\n* 브랜드 전시 카테고리 정보\n * 브랜드 번호(brandNo)를 파라미터로 받는 경우 해당 브랜드 상품들이 속해 있는 전시 카테고리 정보를 subCategoryList를 이용해 대/중/소/세 계층적으로 조회한다.\n","operationId":"getCategoryList","parameters":[{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"전시 카테고리 정보 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisplayCategory"}}}},"400":{"description":"전시 카테고리 정보 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"DisplayCategory":{"type":"object","description":"전시카테고리","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"uprDispCtgNo":{"type":"string","description":"상위전시카테고리번호"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"},"midCtgNo":{"type":"string","description":"중카테고리번호"},"smlCtgNo":{"type":"string","description":"소카테고리번호"},"thnCtgNo":{"type":"string","description":"세카테고리번호"},"leafYn":{"type":"string","description":"최하위 여부"},"depth":{"type":"string","description":"카테고리 depth"},"subCategoryList":{"type":"array","description":"하위 카테고리 리스트","items":{"$ref":"#/components/schemas/DisplayCategory"}}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## 전시카테고리 단건 조회
> \## 기능설명\
> \* 전시 카테고리 번호로 전시 카테고리 정보를 조회한다.\
> \---\
> \## 상세설명\
> \* 단건 전시 카테고리 정보\
> \* 전시카테고리번호(dispCtgNo)를 파라미터로 받아 해당 전시 카테고리 정보만을 조회한다.\
> \* 전달받은 전시 카테고리 번호의 정보만 조회하기 때문에 subCategoryList는 response 값에 제외된다.
```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/displayCategory/{dispCtgNo}":{"get":{"tags":["전시카테고리"],"summary":"전시카테고리 단건 조회","description":"## 기능설명\n* 전시 카테고리 번호로 전시 카테고리 정보를 조회한다.\n---\n## 상세설명\n* 단건 전시 카테고리 정보\n * 전시카테고리번호(dispCtgNo)를 파라미터로 받아 해당 전시 카테고리 정보만을 조회한다.\n * 전달받은 전시 카테고리 번호의 정보만 조회하기 때문에 subCategoryList는 response 값에 제외된다.\n","operationId":"getDisplayCategory","parameters":[{"name":"dispCtgNo","in":"path","description":"전시카테고리번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"전시카테고리 단건 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisplayCategory"}}}},"400":{"description":"전시카테고리 단건 조회 실패","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"DisplayCategory":{"type":"object","description":"전시카테고리","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"uprDispCtgNo":{"type":"string","description":"상위전시카테고리번호"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"},"midCtgNo":{"type":"string","description":"중카테고리번호"},"smlCtgNo":{"type":"string","description":"소카테고리번호"},"thnCtgNo":{"type":"string","description":"세카테고리번호"},"leafYn":{"type":"string","description":"최하위 여부"},"depth":{"type":"string","description":"카테고리 depth"},"subCategoryList":{"type":"array","description":"하위 카테고리 리스트","items":{"$ref":"#/components/schemas/DisplayCategory"}}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```