> 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/goods-api/undefined-6.md).

# 브랜드

## 브랜드 정보 조회

> \## 기능설명\
> \* 브랜드 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 브랜드에 대한 정보를 상세조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없는 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"브랜드 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ..."},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"브랜드 번호 : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"브랜드명"},"schKwdNm":{"type":"string","description":"검색키워드"},"offset":{"type":"integer","format":"int64"}}},"BrandResponse":{"type":"object","description":"브랜드 검색결과 DTO","properties":{"brandNo":{"type":"string","description":"브랜드번호"},"useYn":{"type":"string","description":"사용여부"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"brandNm":{"type":"string","description":"브랜드명"},"brandDescCmt":{"type":"string","description":"브랜드설명내용"},"schKwdNm":{"type":"string","description":"검색키워드명"},"totalCnt":{"type":"integer","format":"int32","description":"갯수"},"productList":{"type":"array","description":"상품리스트","items":{"$ref":"#/components/schemas/BrandProductSummaryResponse"}}}},"BrandProductSummaryResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"goodsNo":{"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":"브랜드번호"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가"},"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:업체배송, 30:e-쿠폰배송"},"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":"string","description":"최근판매가"},"salePrc":{"type":"string","description":"판매가"},"aplyPrc":{"type":"string","description":"적용가"},"dcRate":{"type":"string","description":"할인율"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"goodsImmedDcCpnNo":{"type":"string","description":"상품즉시할인쿠폰번호"},"goodsImmedDcAplyStrDtm":{"type":"string","format":"date-time","description":"상품즉시할인적용시작일시"},"fixamtFxrtGbCd":{"type":"string","description":"상품즉시정액정율구분코드(MK005)"},"dcRateAmt":{"type":"string","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":"상품리뷰도움돼요수"},"goodsRevStfdVal":{"type":"string","description":"상품리뷰만족도값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"ordQty":{"type":"string","description":"주문수량"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"goodsNm":{"type":"string","description":"상품명"},"adveWrd":{"type":"string","description":"홍보문구"},"prestNm":{"type":"string","description":"증정품명"},"brandNm":{"type":"string","description":"브랜드명"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/list":{"post":{"tags":["브랜드"],"summary":"브랜드 정보 조회","description":"## 기능설명\n* 브랜드 정보를 조회합니다.\n---\n## 상세설명\n* 브랜드에 대한 정보를 상세조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없는 경우 발생하는 오류입니다.\n","operationId":"seltBrandsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"브랜드 정보 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BrandResponse"}}}}},"900":{"description":"브랜드 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 브랜드별 신상품 조회

> \## 기능설명\
> \* 브랜드별 신상품의 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"브랜드 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ..."},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"브랜드 번호 : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"브랜드명"},"schKwdNm":{"type":"string","description":"검색키워드"},"offset":{"type":"integer","format":"int64"}}},"ResponseMapStringObject":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/brandNewGoodslist":{"post":{"tags":["브랜드"],"summary":"브랜드별 신상품 조회","description":"## 기능설명\n* 브랜드별 신상품의 정보를 조회합니다.\n---\n## 상세설명\n* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.\n","operationId":"seltBrandNewGoodsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"브랜드별 신상품 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}},"900":{"description":"브랜드별 신상품 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 브랜드별 베스트상품 조회

> \## 기능설명\
> \* 브랜드별 BEST상품의 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"브랜드 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ..."},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"브랜드 번호 : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"브랜드명"},"schKwdNm":{"type":"string","description":"검색키워드"},"offset":{"type":"integer","format":"int64"}}},"ResponseMapStringObject":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/brandBestGoodslist":{"post":{"tags":["브랜드"],"summary":"브랜드별 베스트상품 조회","description":"## 기능설명\n* 브랜드별 BEST상품의 정보를 조회합니다.\n---\n## 상세설명\n* 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.\n","operationId":"seltBrandBestGoodsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"브랜드별 BEST상품 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}},"900":{"description":"브랜드별 BEST상품 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```