브랜드

브랜드 정보 조회

post

기능설명

• 브랜드 정보를 조회합니다.

---

상세설명

• 브랜드에 대한 정보를 상세조회합니다.

---

검증내용

• 1001 : request값이 없는 경우 발생하는 오류입니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

브랜드 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호 : 1,2,3, ...

Default: 1

pageNointeger · int32Optional

호출 페이지 번호

Example: 1

pageSizeinteger · int32Optional

호출 페이지 사이즈

Example: 20

dispYnstring · enumOptional

전시여부 : Y/N

Default: YPossible values:

brandNostring[]Optional

브랜드 번호 : 123, ...

brandNmstringOptional

브랜드명

Example: dior

schKwdNmstringOptional

검색키워드

Example: dior

offsetinteger · int64Optional

Responses

200

브랜드 정보 조회 성공

*/*

브랜드 검색결과 DTO

brandNostringOptional

브랜드번호

Example: 1

useYnstringOptional

사용여부

Example: Y

brandImgPathNmstringOptional

브랜드이미지경로명

brandImgFileNmstringOptional

브랜드이미지파일명

langCdstringOptional

언어코드(CM009) ko:한국어, en:영어

Example: ko

brandNmstringOptional

브랜드명

Example: 브랜드명

brandDescCmtstringOptional

브랜드설명내용

Example: 브랜드설명내용

schKwdNmstringOptional

검색키워드명

Example: 검색키워드명

totalCntinteger · int32Optional

갯수

Example: 123

900

브랜드 정보 조회 실패

*/*

post

/v1/brands/list

HTTPcURLJavaScriptPython

POST /api/goods/v1/brands/list HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "langCd": "ko",
  "siteNo": "1",
  "pageNo": 1,
  "pageSize": 20,
  "dispYn": "Y",
  "brandNo": [
    "text"
  ],
  "brandNm": "dior",
  "schKwdNm": "dior",
  "offset": 1
}

[
  {
    "brandNo": 1,
    "useYn": "Y",
    "brandImgPathNm": "text",
    "brandImgFileNm": "text",
    "langCd": "ko",
    "brandNm": "브랜드명",
    "brandDescCmt": "브랜드설명내용",
    "schKwdNm": "검색키워드명",
    "totalCnt": 123,
    "productList": [
      {
        "goodsNo": 100000001,
        "entrNo": 1000001,
        "goodsCompCd": 10,
        "goodsTypCd": 10,
        "saleMethCd": 10,
        "brandNo": 1,
        "buyrAgeLmtCd": 0,
        "dispYn": "Y",
        "saleStatCd": 10,
        "goodsRegDtm": "2021-01-01 00:00:00",
        "saleStrDtm": "2021-01-01 00:00:00",
        "saleEndDtm": "2029-01-01 00:00:00",
        "stkMgrYn": "Y",
        "deliProcTypCd": 10,
        "deliGoodsGbCd": "01",
        "deliWayCd": 10,
        "deliDday": 1,
        "deliPolcNo": 1,
        "prcHistStrDtm": "2021-01-01 00:00:00",
        "prcHistEndDtm": "2029-01-01 00:00:00",
        "rcntSalePrc": "text",
        "salePrc": 10000,
        "aplyPrc": 10000,
        "dcRate": 25,
        "dispCtgNo": 1,
        "dlexTypCd": 10,
        "goodsImmedDcCpnNo": 1,
        "goodsImmedDcAplyStrDtm": "2021-01-01 00:00:00",
        "fixamtFxrtGbCd": "text",
        "dcRateAmt": "text",
        "goodsRepImgContSn": 1,
        "rservSaleYn": "Y",
        "rservStrDtm": "2021-01-01 00:00:00",
        "rservEndDtm": "2029-01-01 00:00:00",
        "goodsRevCnt": 1,
        "goodsRevHlpfulCnt": 1,
        "goodsRevStfdVal": 1,
        "wishListCnt": 10,
        "ordQty": "text",
        "langCd": "ko",
        "goodsNm": "상품명",
        "adveWrd": "홍보문구",
        "prestNm": "증정품명",
        "brandNm": "디올",
        "brandImgPathNm": "attachment/goods/2023/06/20/99a81a54-9b0a-4a83.jpg",
        "brandImgFileNm": "브랜드로고이미지.jpg",
        "goodsRepImgPathNm": "상품대표이미지.jpg",
        "trnfTextCont": "상품대표이미지 대체텍스트"
      }
    ]
  }
]

브랜드별 신상품 조회

post

기능설명

• 브랜드별 신상품의 정보를 조회합니다.

---

상세설명

• 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.

---

검증내용

• 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

브랜드 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호 : 1,2,3, ...

Default: 1

pageNointeger · int32Optional

호출 페이지 번호

Example: 1

pageSizeinteger · int32Optional

호출 페이지 사이즈

Example: 20

dispYnstring · enumOptional

전시여부 : Y/N

Default: YPossible values:

brandNostring[]Optional

브랜드 번호 : 123, ...

brandNmstringOptional

브랜드명

Example: dior

schKwdNmstringOptional

검색키워드

Example: dior

offsetinteger · int64Optional

Responses

200

브랜드별 신상품 정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

브랜드별 신상품 정보 조회 실패

*/*

post

/v1/brands/brandNewGoodslist

HTTPcURLJavaScriptPython

POST /api/goods/v1/brands/brandNewGoodslist HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "langCd": "ko",
  "siteNo": "1",
  "pageNo": 1,
  "pageSize": 20,
  "dispYn": "Y",
  "brandNo": [
    "text"
  ],
  "brandNm": "dior",
  "schKwdNm": "dior",
  "offset": 1
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

브랜드별 베스트상품 조회

post

기능설명

• 브랜드별 BEST상품의 정보를 조회합니다.

---

상세설명

• 각 브랜드의 최근 상품등록일 순으로 10개의 상품을 조회합니다.

---

검증내용

• 1001 : request값이 없거나 request값에 브랜드 번호가 경우 발생하는 오류입니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

브랜드 조회관련 조건 DTO

langCdstringOptional

언어코드(CM009)

Default: koExample: ko

siteNostringOptional

사이트번호 : 1,2,3, ...

Default: 1

pageNointeger · int32Optional

호출 페이지 번호

Example: 1

pageSizeinteger · int32Optional

호출 페이지 사이즈

Example: 20

dispYnstring · enumOptional

전시여부 : Y/N

Default: YPossible values:

brandNostring[]Optional

브랜드 번호 : 123, ...

brandNmstringOptional

브랜드명

Example: dior

schKwdNmstringOptional

검색키워드

Example: dior

offsetinteger · int64Optional

Responses

200

브랜드별 BEST상품 정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

브랜드별 BEST상품 정보 조회 실패

*/*

post

/v1/brands/brandBestGoodslist

HTTPcURLJavaScriptPython

POST /api/goods/v1/brands/brandBestGoodslist HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "langCd": "ko",
  "siteNo": "1",
  "pageNo": 1,
  "pageSize": 20,
  "dispYn": "Y",
  "brandNo": [
    "text"
  ],
  "brandNm": "dior",
  "schKwdNm": "dior",
  "offset": 1
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}