Ctrlk
X2BEE 바로가기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

브랜드

브랜드 정보 조회

post

기능설명

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

상세설명

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

검증내용

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
AuthorizationanyOptional

Access Token

Body

브랜드 조회관련 조건 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
post/v1/brands/list
POST /api/goods/v1/brands/list HTTP/1.1
Host: api-goods.x2bee.com/
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
AuthorizationanyOptional

Access Token

Body

브랜드 조회관련 조건 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

post/v1/brands/brandNewGoodslist
POST /api/goods/v1/brands/brandNewGoodslist HTTP/1.1
Host: api-goods.x2bee.com/
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-01-01T00:00:00.000Z",
  "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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
AuthorizationanyOptional

Access Token

Body

브랜드 조회관련 조건 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

post/v1/brands/brandBestGoodslist
POST /api/goods/v1/brands/brandBestGoodslist HTTP/1.1
Host: api-goods.x2bee.com/
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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}
이전상품상세 배송정보
다음Models

마지막 업데이트