> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined.md).
# 키워드 부스팅 관리
## 키워드 부스팅 상세 조회
> \## 기능설명\
> \* 키워드 부스팅 상세정보를 조회하는 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"}}}}}}}}}
````