키워드 부스팅 관리

키워드 부스팅 상세 조회

get

기능설명

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

---

상세설명

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

---

수정번호

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

Authorizations

accessToken

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}

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-02-27T18:20:50.124Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "siteNo": 51,
    "bstNo": 1,
    "kwd": "러닝화",
    "useYn": "Y",
    "aplyCategory": [],
    "aplyBrand": []
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 상세 수정

put

기능설명

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

---

상세설명

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

---

수정번호

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

bstNostringRequired

string

Example: 100

Body

application/json

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

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}

HTTPcURLJavaScriptPython

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-02-27T18:20:50.124Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 유효성 검증

post

기능설명

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

---

상세설명

• 검증 항목

  • 키워드 중복 체크 (동일 사이트 내)

  • 전시카테고리 유효성 검증

• 신규 등록 시: bstNo 없이 호출

• 수정 시: bstNo 포함하여 호출 (자기 자신 제외)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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

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

HTTPcURLJavaScriptPython

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-02-27T18:20:50.124Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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

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

HTTPcURLJavaScriptPython

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-02-27T18:20:50.124Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

키워드 부스팅 목록 조회

get

기능설명

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

---

상세설명

• 검색조건 : 키워드, 사이트번호, 사용여부, 부스팅유형

• 키워드 부스팅 목록은 부스팅번호 내림차순으로 노출됩니다.

• 부스팅유형: brand(브랜드), category(카테고리)

---

수정번호

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

Authorizations

accessToken

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

HTTPcURLJavaScriptPython

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-02-27T18:20:50.124Z",
  "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

accessToken

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

HTTPcURLJavaScriptPython

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-02-27T18:20:50.124Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}