# 전시카테고리
## 전시 아이콘 목록 조회
> \## 기능설명\
> \* 전시 아이콘 목록을 조회하는 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"}}}}}}
```
---
# 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-4.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.