# 약관 이용안내 관리

## 약관/이용안내 목록 조회

> \## 기능설명\
> \* 약관/이용안내 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 공통약관정책구분코드,약관정책코드,사이트번호,약관제목의 조회조건에 따라 약관/이용안내 정보를 조회합니다.\
> \* 약관/이용안내 정보 목록은 수정날짜 내림차순으로 노출됩니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.02\_231023\`\`\` : 스프린트2 PO1 결함/개선\
> \* \`\`\`Release v1.05\_231204\`\`\` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선<br>

````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":{"CcCmAgmtPolcInfo":{"type":"object","description":"공통약관정책정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"siteNm":{"type":"string","description":"사이트명"},"cmAgmtPolcGbCd":{"type":"string","description":"공통약관정책구분코드(CH010)"},"cmAgmtGbNm":{"type":"string","description":"약관정책구분명"},"agmtPolcCd":{"type":"string","description":"약관정책코드(CH005)"},"agmtPolcNm":{"type":"string","description":"약관정책코드명"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"title":{"type":"string","description":"제목"},"wrdCont":{"type":"string","description":"문구내용"},"titleOther":{"type":"string","description":"제목"},"wrdContOther":{"type":"string","description":"문구내용"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/termsConditionsMgmt":{"get":{"tags":["약관 이용안내 관리"],"summary":"약관/이용안내 목록 조회","description":"## 기능설명\n* 약관/이용안내 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 공통약관정책구분코드,약관정책코드,사이트번호,약관제목의 조회조건에 따라 약관/이용안내 정보를 조회합니다.\n* 약관/이용안내 정보 목록은 수정날짜 내림차순으로 노출됩니다.\n---\n## 수정번호\n* ```Release v1.02_231023``` : 스프린트2 PO1 결함/개선\n* ```Release v1.05_231204``` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선\n","operationId":"getTermsConditionsList","parameters":[{"name":"cmAgmtPolcGbCd","in":"query","description":"공통약관정책구분코드","schema":{"type":"string"}},{"name":"agmtPolcCd","in":"query","description":"약관정책코드","schema":{"type":"string"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string"}},{"name":"title","in":"query","description":"약관제목","schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"약관/이용안내 정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CcCmAgmtPolcInfo"}}}},"900":{"description":"약관/이용안내 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 약관/이용안내 등록 및 수정

> \## 기능설명\
> \* 사이트 기준으로 약관/이용안내 상세정보를 등록 및 수정하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* create : siteNo \*, cmAgmtPolcGbCd \*, agmtPolcCd \*, aplyStrDt \*, aplyEndDt \*, langCd \*, title \*, wrdCont \*\
> &#x20;   \* update : siteNo \*, cmAgmtSeq \*, cmAgmtPolcGbCd \*, agmtPolcCd \*, aplyStrDt \*, aplyEndDt \*, langCd \*, title \*, wrdCont \*<br>

```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":{"CcCmAgmtPolcInfo":{"type":"object","description":"공통약관정책정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"siteNm":{"type":"string","description":"사이트명"},"cmAgmtPolcGbCd":{"type":"string","description":"공통약관정책구분코드(CH010)"},"cmAgmtGbNm":{"type":"string","description":"약관정책구분명"},"agmtPolcCd":{"type":"string","description":"약관정책코드(CH005)"},"agmtPolcNm":{"type":"string","description":"약관정책코드명"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"title":{"type":"string","description":"제목"},"wrdCont":{"type":"string","description":"문구내용"},"titleOther":{"type":"string","description":"제목"},"wrdContOther":{"type":"string","description":"문구내용"}}},"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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/termsConditionsMgmt":{"post":{"tags":["약관 이용안내 관리"],"summary":"약관/이용안내 등록 및 수정","description":"## 기능설명\n* 사이트 기준으로 약관/이용안내 상세정보를 등록 및 수정하는 API 입니다.\n---\n## 상세설명\n* 입력 파라미터( * : 필수)\n    * create : siteNo *, cmAgmtPolcGbCd *, agmtPolcCd *, aplyStrDt *, aplyEndDt *, langCd *, title *, wrdCont *\n    * update : siteNo *, cmAgmtSeq *, cmAgmtPolcGbCd *, agmtPolcCd *, aplyStrDt *, aplyEndDt *, langCd *, title *, wrdCont *\n","operationId":"saveCcCmAgmtPolcInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CcCmAgmtPolcInfo"}}},"required":true},"responses":{"200":{"description":"약관/이용안내 정보 등록/수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"약관/이용안내 정보 등록/수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 약관/이용안내 다국어 등록 및 수정

> \## 기능설명\
> \* 사이트 기준으로 약관/이용안내 다국어 정보를 등록 및 수정하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 입력 파라미터( \* : 필수)\
> &#x20;   \* update : cmAgmtSeq \*, langCd \*, title \*, wrdCont \*<br>

```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":{"CcCmAgmtPolcInfo":{"type":"object","description":"공통약관정책정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"siteNm":{"type":"string","description":"사이트명"},"cmAgmtPolcGbCd":{"type":"string","description":"공통약관정책구분코드(CH010)"},"cmAgmtGbNm":{"type":"string","description":"약관정책구분명"},"agmtPolcCd":{"type":"string","description":"약관정책코드(CH005)"},"agmtPolcNm":{"type":"string","description":"약관정책코드명"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"title":{"type":"string","description":"제목"},"wrdCont":{"type":"string","description":"문구내용"},"titleOther":{"type":"string","description":"제목"},"wrdContOther":{"type":"string","description":"문구내용"}}},"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"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/termsConditionsMgmt/multiLang":{"post":{"tags":["약관 이용안내 관리"],"summary":"약관/이용안내 다국어 등록 및 수정","description":"## 기능설명\n* 사이트 기준으로 약관/이용안내 다국어 정보를 등록 및 수정하는 API 입니다.\n---\n## 상세설명\n* 입력 파라미터( * : 필수)\n    * update : cmAgmtSeq *, langCd *, title *, wrdCont *\n","operationId":"saveCcCmAgmtPolcInfoMl","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CcCmAgmtPolcInfo"}}},"required":true},"responses":{"200":{"description":"약관/이용안내 다국어 정보 등록/수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"약관/이용안내 다국어 정보 등록/수정 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 약관/이용안내 상세정보 조회

> \## 기능설명\
> \* 약관/이용안내 상세정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 공통약관순번으로 해당 약관/이용안내 상세정보를 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.05\_231204\`\`\` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선<br>

````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":{"CcCmAgmtPolcInfo":{"type":"object","description":"공통약관정책정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"siteNm":{"type":"string","description":"사이트명"},"cmAgmtPolcGbCd":{"type":"string","description":"공통약관정책구분코드(CH010)"},"cmAgmtGbNm":{"type":"string","description":"약관정책구분명"},"agmtPolcCd":{"type":"string","description":"약관정책코드(CH005)"},"agmtPolcNm":{"type":"string","description":"약관정책코드명"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"title":{"type":"string","description":"제목"},"wrdCont":{"type":"string","description":"문구내용"},"titleOther":{"type":"string","description":"제목"},"wrdContOther":{"type":"string","description":"문구내용"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/termsConditionsMgmt/{cmAgmtSeq}":{"get":{"tags":["약관 이용안내 관리"],"summary":"약관/이용안내 상세정보 조회","description":"## 기능설명\n* 약관/이용안내 상세정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 공통약관순번으로 해당 약관/이용안내 상세정보를 조회합니다.\n---\n## 수정번호\n* ```Release v1.05_231204``` : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선\n","operationId":"getAgmtUtilGuideByCmAgmtSeq","parameters":[{"name":"cmAgmtSeq","in":"query","description":"공통약관순번","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"약관/이용안내 상세정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CcCmAgmtPolcInfo"}}}},"900":{"description":"약관/이용안내 상세정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 약관/이용안내 다국어 상세정보 조회

> \## 기능설명\
> \* 약관/이용안내 다국어 상세정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 공통약관순번으로 해당 약관/이용안내 다국어 상세정보를 조회합니다.<br>

```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":{"CcCmAgmtPolcInfo":{"type":"object","description":"공통약관정책정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cmAgmtSeq":{"type":"string","description":"공통약관순번"},"siteNm":{"type":"string","description":"사이트명"},"cmAgmtPolcGbCd":{"type":"string","description":"공통약관정책구분코드(CH010)"},"cmAgmtGbNm":{"type":"string","description":"약관정책구분명"},"agmtPolcCd":{"type":"string","description":"약관정책코드(CH005)"},"agmtPolcNm":{"type":"string","description":"약관정책코드명"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"title":{"type":"string","description":"제목"},"wrdCont":{"type":"string","description":"문구내용"},"titleOther":{"type":"string","description":"제목"},"wrdContOther":{"type":"string","description":"문구내용"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/termsConditionsMgmt/multiLang/{cmAgmtSeq}":{"get":{"tags":["약관 이용안내 관리"],"summary":"약관/이용안내 다국어 상세정보 조회","description":"## 기능설명\n* 약관/이용안내 다국어 상세정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 공통약관순번으로 해당 약관/이용안내 다국어 상세정보를 조회합니다.\n","operationId":"getCcCmAgmtPolcInfoMlBy","parameters":[{"name":"cmAgmtSeq","in":"query","description":"공통약관순번","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"약관/이용안내 다국어 상세정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CcCmAgmtPolcInfo"}}}},"900":{"description":"약관/이용안내 다국어 상세정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```


---

# 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/display-bo-api/undefined-3.md?ask=<question>
```

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.
