# 키워드 부스팅 관리
## 키워드 부스팅 상세 조회
> \## 기능설명\
> \* 키워드 부스팅 상세정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 키워드 부스팅 상세정보를 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\` : 키워드 부스팅 설정
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseKwdBoostingDetailResponse":{"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":{"$ref":"#/components/schemas/KwdBoostingDetailResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"KwdBoostingDetailResponse":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"bstNo":{"type":"string","description":"부스팅번호"},"kwd":{"type":"string","description":"키워드"},"useYn":{"type":"string","description":"사용여부"},"aplyCategory":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string"},"description":"적용 조건 - 전시카테고리"}},"aplyBrand":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string"},"description":"적용 조건 - 브랜드"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"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":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/search/kwdBoostingMgmt/{bstNo}":{"get":{"tags":["키워드 부스팅 관리"],"summary":"키워드 부스팅 상세 조회","description":"## 기능설명\n* 키워드 부스팅 상세정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 키워드 부스팅 상세정보를 조회합니다.\n---\n## 수정번호\n* ```Release v1.04_231120``` : 키워드 부스팅 설정\n","operationId":"detail","parameters":[{"name":"bstNo","in":"path","description":"부스팅번호","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseKwdBoostingDetailResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## 키워드 부스팅 상세 수정
> \## 기능설명\
> \* 키워드 부스팅 상세정보를 수정하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 키워드 부스팅 상세정보를 수정합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\` : 키워드 부스팅 설정
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"KwdBoostingSaveRequest":{"type":"object","description":"키워드 부스팅 저장 요청 모델","properties":{"siteNo":{"type":"string","description":"사이트번호"},"bstNo":{"type":"string","description":"부스팅번호"},"kwd":{"type":"string","description":"키워드"},"useYn":{"type":"string","description":"사용여부"},"aplyCategory":{"type":"array","description":"적용 카테고리 목록","items":{"type":"string"}},"aplyBrand":{"type":"array","description":"적용 브랜드 목록","items":{"type":"string"}}}},"ResponseString":{"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":"string","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"}}},"Response":{"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":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/search/kwdBoostingMgmt/{bstNo}":{"put":{"tags":["키워드 부스팅 관리"],"summary":"키워드 부스팅 상세 수정","description":"## 기능설명\n* 키워드 부스팅 상세정보를 수정하는 API 입니다.\n---\n## 상세설명\n* 키워드 부스팅 상세정보를 수정합니다.\n---\n## 수정번호\n* ```Release v1.04_231120``` : 키워드 부스팅 설정\n","operationId":"modify","parameters":[{"name":"bstNo","in":"path","description":"부스팅번호","required":true,"schema":{"type":"string","description":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KwdBoostingSaveRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## 키워드 부스팅 유효성 검증
> \## 기능설명\
> \* 키워드 부스팅 정보의 유효성을 검증하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 검증 항목\
> \- 키워드 중복 체크 (동일 사이트 내)\
> \- 전시카테고리 유효성 검증\
> \* 신규 등록 시: bstNo 없이 호출\
> \* 수정 시: bstNo 포함하여 호출 (자기 자신 제외)\
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"KwdBoostingSaveRequest":{"type":"object","description":"키워드 부스팅 저장 요청 모델","properties":{"siteNo":{"type":"string","description":"사이트번호"},"bstNo":{"type":"string","description":"부스팅번호"},"kwd":{"type":"string","description":"키워드"},"useYn":{"type":"string","description":"사용여부"},"aplyCategory":{"type":"array","description":"적용 카테고리 목록","items":{"type":"string"}},"aplyBrand":{"type":"array","description":"적용 브랜드 목록","items":{"type":"string"}}}},"ResponseString":{"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":"string","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"}}},"Response":{"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":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/search/kwdBoostingMgmt/validate":{"post":{"tags":["키워드 부스팅 관리"],"summary":"키워드 부스팅 유효성 검증","description":"## 기능설명\n* 키워드 부스팅 정보의 유효성을 검증하는 API 입니다.\n---\n## 상세설명\n* 검증 항목\n - 키워드 중복 체크 (동일 사이트 내)\n - 전시카테고리 유효성 검증\n* 신규 등록 시: bstNo 없이 호출\n* 수정 시: bstNo 포함하여 호출 (자기 자신 제외)\n\n","operationId":"validate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KwdBoostingSaveRequest"}}},"required":true},"responses":{"200":{"description":"성공 (유효성 검증 통과)","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"유효성 검증 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 키워드 부스팅 정보 등록
> \## 기능설명\
> \* 키워드 부스팅 정보를 등록하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 입력 파라미터( \* : 필수)\
> \* create : kwd \*, useYn \*, siteNo \*\
> \* update : bstNo \*, kwd \*, useYn \*, siteNo \*\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\` : 키워드 부스팅 설정
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"KwdBoostingSaveRequest":{"type":"object","description":"키워드 부스팅 저장 요청 모델","properties":{"siteNo":{"type":"string","description":"사이트번호"},"bstNo":{"type":"string","description":"부스팅번호"},"kwd":{"type":"string","description":"키워드"},"useYn":{"type":"string","description":"사용여부"},"aplyCategory":{"type":"array","description":"적용 카테고리 목록","items":{"type":"string"}},"aplyBrand":{"type":"array","description":"적용 브랜드 목록","items":{"type":"string"}}}},"ResponseString":{"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":"string","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"}}},"Response":{"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":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/search/kwdBoostingMgmt/save":{"post":{"tags":["키워드 부스팅 관리"],"summary":"키워드 부스팅 정보 등록","description":"## 기능설명\n* 키워드 부스팅 정보를 등록하는 API 입니다.\n---\n## 상세설명\n* 입력 파라미터( * : 필수)\n * create : kwd *, useYn *, siteNo *\n * update : bstNo *, kwd *, useYn *, siteNo *\n---\n## 수정번호\n* ```Release v1.04_231120``` : 키워드 부스팅 설정\n","operationId":"save","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KwdBoostingSaveRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## 키워드 부스팅 목록 조회
> \## 기능설명\
> \* 키워드 부스팅 정보 목록을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 검색조건 : 키워드, 사이트번호, 사용여부, 부스팅유형\
> \* 키워드 부스팅 목록은 부스팅번호 내림차순으로 노출됩니다.\
> \* 부스팅유형: brand(브랜드), category(카테고리)\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\` : 키워드 부스팅 설정
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseRealGridListResponseKwdBoostingBase":{"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":{"$ref":"#/components/schemas/RealGridListResponseKwdBoostingBase","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseKwdBoostingBase":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/KwdBoostingBase"}}}},"KwdBoostingBase":{"type":"object","description":"키워드 부스팅 기본 모델","properties":{"siteNo":{"type":"string","description":"사이트번호"},"bstNo":{"type":"string","description":"부스팅번호"},"kwd":{"type":"string","description":"키워드"},"useYn":{"type":"string","description":"사용여부"},"bstTypCdList":{"type":"string","description":"부스팅유형코드목록"},"bstType":{"type":"string","description":"부스팅 유형"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"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":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/search/kwdBoostingMgmt/getKwdBoostingList":{"get":{"tags":["키워드 부스팅 관리"],"summary":"키워드 부스팅 목록 조회","description":"## 기능설명\n* 키워드 부스팅 정보 목록을 조회하는 API 입니다.\n---\n## 상세설명\n* 검색조건 : 키워드, 사이트번호, 사용여부, 부스팅유형\n* 키워드 부스팅 목록은 부스팅번호 내림차순으로 노출됩니다.\n* 부스팅유형: brand(브랜드), category(카테고리)\n---\n## 수정번호\n* ```Release v1.04_231120``` : 키워드 부스팅 설정\n","operationId":"getKwdBoostingList","parameters":[{"name":"kwd","in":"query","description":"키워드","schema":{"type":"string"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"bstType","in":"query","description":"부스팅유형","schema":{"type":"string","enum":["brand","category"]}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseKwdBoostingBase"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## 키워드 부스팅 정보 삭제
> \## 기능설명\
> \* 키워드 부스팅 정보를 삭제하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 부스팅번호으로 키워드 부스팅 정보를 삭제합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\` : 키워드 부스팅 설정
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseString":{"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":"string","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"}}},"Response":{"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":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/search/kwdBoostingMgmt/list":{"delete":{"tags":["키워드 부스팅 관리"],"summary":"키워드 부스팅 정보 삭제","description":"## 기능설명\n* 키워드 부스팅 정보를 삭제하는 API 입니다.\n---\n## 상세설명\n* 부스팅번호으로 키워드 부스팅 정보를 삭제합니다.\n---\n## 수정번호\n* ```Release v1.04_231120``` : 키워드 부스팅 설정\n","operationId":"delete","parameters":[{"name":"bstNoList","in":"query","description":"부스팅번호 배열","required":true,"schema":{"type":"array"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.