키워드 부스팅 관리

키워드 부스팅 상세 조회

get

기능설명

키워드 부스팅 상세정보를 조회하는 API 입니다.

상세설명

키워드 부스팅 상세정보를 조회합니다.

수정번호

Release v1.04_231120 : 키워드 부스팅 설정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

bstNostringRequired

string

Example: 100

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get/v1/search/kwdBoostingMgmt/{bstNo}

GET /api/bo/v1/search/kwdBoostingMgmt/{bstNo} HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "siteNo": 51,
    "bstNo": 1,
    "kwd": "러닝화",
    "useYn": "Y",
    "aplyCategory": [
      "{'data':'전시카테고리 명',key:'100'}"
    ],
    "aplyBrand": [
      "{'data':'브랜드 명',key:'BR01'}"
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 상세 수정

put

기능설명

키워드 부스팅 상세정보를 수정하는 API 입니다.

상세설명

키워드 부스팅 상세정보를 수정합니다.

수정번호

Release v1.04_231120 : 키워드 부스팅 설정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

bstNostringRequired

string

Example: 100

Body

키워드 부스팅 저장 요청 모델

siteNostringOptional

사이트번호

Example: 51

bstNostringOptional

부스팅번호

Example: 1

kwdstringOptional

키워드

Example: 러닝화

useYnstringOptional

사용여부

Example: Y

aplyCategorystring[]Optional

적용 카테고리 목록

aplyBrandstring[]Optional

적용 브랜드 목록

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

put/v1/search/kwdBoostingMgmt/{bstNo}

PUT /api/bo/v1/search/kwdBoostingMgmt/{bstNo} HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "siteNo": 51,
  "bstNo": 1,
  "kwd": "러닝화",
  "useYn": "Y",
  "aplyCategory": [
    "text"
  ],
  "aplyBrand": [
    "text"
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 유효성 검증

post

기능설명

키워드 부스팅 정보의 유효성을 검증하는 API 입니다.

상세설명

검증 항목
- 키워드 중복 체크 (동일 사이트 내)
- 전시카테고리 유효성 검증
신규 등록 시: bstNo 없이 호출
수정 시: bstNo 포함하여 호출 (자기 자신 제외)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

키워드 부스팅 저장 요청 모델

siteNostringOptional

사이트번호

Example: 51

bstNostringOptional

부스팅번호

Example: 1

kwdstringOptional

키워드

Example: 러닝화

useYnstringOptional

사용여부

Example: Y

aplyCategorystring[]Optional

적용 카테고리 목록

aplyBrandstring[]Optional

적용 브랜드 목록

Responses

200

성공 (유효성 검증 통과)

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

유효성 검증 실패

*/*

post/v1/search/kwdBoostingMgmt/validate

POST /api/bo/v1/search/kwdBoostingMgmt/validate HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "siteNo": 51,
  "bstNo": 1,
  "kwd": "러닝화",
  "useYn": "Y",
  "aplyCategory": [
    "text"
  ],
  "aplyBrand": [
    "text"
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 정보 등록

post

기능설명

키워드 부스팅 정보를 등록하는 API 입니다.

상세설명

입력 파라미터( * : 필수)
- create : kwd *, useYn *, siteNo *
- update : bstNo *, kwd *, useYn *, siteNo *

수정번호

Release v1.04_231120 : 키워드 부스팅 설정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

키워드 부스팅 저장 요청 모델

siteNostringOptional

사이트번호

Example: 51

bstNostringOptional

부스팅번호

Example: 1

kwdstringOptional

키워드

Example: 러닝화

useYnstringOptional

사용여부

Example: Y

aplyCategorystring[]Optional

적용 카테고리 목록

aplyBrandstring[]Optional

적용 브랜드 목록

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post/v1/search/kwdBoostingMgmt/save

POST /api/bo/v1/search/kwdBoostingMgmt/save HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "siteNo": 51,
  "bstNo": 1,
  "kwd": "러닝화",
  "useYn": "Y",
  "aplyCategory": [
    "text"
  ],
  "aplyBrand": [
    "text"
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 목록 조회

get

기능설명

키워드 부스팅 정보 목록을 조회하는 API 입니다.

상세설명

검색조건 : 키워드, 사이트번호, 사용여부, 부스팅유형
키워드 부스팅 목록은 부스팅번호 내림차순으로 노출됩니다.
부스팅유형: brand(브랜드), category(카테고리)

수정번호

Release v1.04_231120 : 키워드 부스팅 설정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

kwdstringOptional

키워드

Example: 러닝화

siteNostringOptional

사이트번호

Example: X2BEE

useYnstringOptional

사용여부

Example: Y

bstTypestring · enumOptional

부스팅유형

Example: brandPossible values:

pageIdxstringRequired

현재 페이지

Example: 1

rowsPerPagestringRequired

페이지 당 row

Example: 100

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get/v1/search/kwdBoostingMgmt/getKwdBoostingList

GET /api/bo/v1/search/kwdBoostingMgmt/getKwdBoostingList?pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "siteNo": 51,
        "bstNo": 1,
        "kwd": "러닝화",
        "useYn": "Y",
        "bstTypCdList": "10,30,50",
        "bstType": "카테고리, 브랜드"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 정보 삭제

delete

기능설명

키워드 부스팅 정보를 삭제하는 API 입니다.

상세설명

부스팅번호으로 키워드 부스팅 정보를 삭제합니다.

수정번호

Release v1.04_231120 : 키워드 부스팅 설정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

bstNoListarrayRequired

부스팅번호 배열

Example: B20250901001,B20250901002

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

delete/v1/search/kwdBoostingMgmt/list

DELETE /api/bo/v1/search/kwdBoostingMgmt/list?bstNoList=undefined HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

이전상품(Goods) BO API

다음검색창 마크업 관리

마지막 업데이트 7일 전