약관 이용안내 관리

약관/이용안내 목록 조회

get

기능설명

• 약관/이용안내 정보를 조회하는 API 입니다.

---

상세설명

• 공통약관정책구분코드,약관정책코드,사이트번호,약관제목의 조회조건에 따라 약관/이용안내 정보를 조회합니다.

• 약관/이용안내 정보 목록은 수정날짜 내림차순으로 노출됩니다.

---

수정번호

• Release v1.02_231023 : 스프린트2 PO1 결함/개선

• Release v1.05_231204 : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cmAgmtPolcGbCdstringOptional

공통약관정책구분코드

Example: 10202

agmtPolcCdstringOptional

약관정책코드

Example: 300

siteNostringOptional

사이트번호

Example: 1

titlestringOptional

약관제목

Example: 개인정보처리방침

rowsPerPagestringRequired

페이지 당 row

Example: 100

pageIdxstringRequired

현재 페이지

Example: 1

Responses

200

약관/이용안내 정보 조회 성공

*/*

공통약관정책정보

siteNostringOptional

사이트번호

Example: 1

langCdstringOptional

언어코드(CM009)

Example: ko

cmAgmtSeqstringOptional

공통약관순번

Example: 10202

siteNmstringOptional

사이트명

Example: x2bee

cmAgmtPolcGbCdstringOptional

공통약관정책구분코드(CH010)

Example: 300

cmAgmtGbNmstringOptional

약관정책구분명

Example: 개인정보처리방침

agmtPolcCdstringOptional

약관정책코드(CH005)

Example: 300

agmtPolcNmstringOptional

약관정책코드명

Example: 개인정보처리방침

aplyStrDtstringOptional

적용시작일자

Example: 20230101

aplyEndDtstringOptional

적용종료일자

Example: 20231231

titlestringOptional

제목

Example: 약관정책코드제목

wrdContstringOptional

문구내용

Example: 약관정책코드 문구내용

titleOtherstringOptional

제목

Example: 약관정책코드제목

wrdContOtherstringOptional

문구내용

Example: 약관정책코드 문구내용

900

약관/이용안내 정보 조회 실패

*/*

get

/v2/display/termsConditionsMgmt

HTTPcURLJavaScriptPython

GET /api/bo/v2/display/termsConditionsMgmt?rowsPerPage=text&pageIdx=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "siteNo": 1,
  "langCd": "ko",
  "cmAgmtSeq": 10202,
  "siteNm": "x2bee",
  "cmAgmtPolcGbCd": 300,
  "cmAgmtGbNm": "개인정보처리방침",
  "agmtPolcCd": 300,
  "agmtPolcNm": "개인정보처리방침",
  "aplyStrDt": 20230101,
  "aplyEndDt": 20231231,
  "title": "약관정책코드제목",
  "wrdCont": "약관정책코드 문구내용",
  "titleOther": "약관정책코드제목",
  "wrdContOther": "약관정책코드 문구내용"
}

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

post

기능설명

• 사이트 기준으로 약관/이용안내 상세정보를 등록 및 수정하는 API 입니다.

---

상세설명

• 입력 파라미터( * : 필수)

  • create : siteNo *, cmAgmtPolcGbCd *, agmtPolcCd *, aplyStrDt *, aplyEndDt *, langCd *, title *, wrdCont *

  • update : siteNo *, cmAgmtSeq *, cmAgmtPolcGbCd *, agmtPolcCd *, aplyStrDt *, aplyEndDt *, langCd *, title *, wrdCont *

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

공통약관정책정보

siteNostringOptional

사이트번호

Example: 1

langCdstringOptional

언어코드(CM009)

Example: ko

cmAgmtSeqstringOptional

공통약관순번

Example: 10202

siteNmstringOptional

사이트명

Example: x2bee

cmAgmtPolcGbCdstringOptional

공통약관정책구분코드(CH010)

Example: 300

cmAgmtGbNmstringOptional

약관정책구분명

Example: 개인정보처리방침

agmtPolcCdstringOptional

약관정책코드(CH005)

Example: 300

agmtPolcNmstringOptional

약관정책코드명

Example: 개인정보처리방침

aplyStrDtstringOptional

적용시작일자

Example: 20230101

aplyEndDtstringOptional

적용종료일자

Example: 20231231

titlestringOptional

제목

Example: 약관정책코드제목

wrdContstringOptional

문구내용

Example: 약관정책코드 문구내용

titleOtherstringOptional

제목

Example: 약관정책코드제목

wrdContOtherstringOptional

문구내용

Example: 약관정책코드 문구내용

Responses

200

약관/이용안내 정보 등록/수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

약관/이용안내 정보 등록/수정 실패

*/*

post

/v2/display/termsConditionsMgmt

HTTPcURLJavaScriptPython

POST /api/bo/v2/display/termsConditionsMgmt HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 389

{
  "siteNo": 1,
  "langCd": "ko",
  "cmAgmtSeq": 10202,
  "siteNm": "x2bee",
  "cmAgmtPolcGbCd": 300,
  "cmAgmtGbNm": "개인정보처리방침",
  "agmtPolcCd": 300,
  "agmtPolcNm": "개인정보처리방침",
  "aplyStrDt": 20230101,
  "aplyEndDt": 20231231,
  "title": "약관정책코드제목",
  "wrdCont": "약관정책코드 문구내용",
  "titleOther": "약관정책코드제목",
  "wrdContOther": "약관정책코드 문구내용"
}

{
  "timestamp": "2026-02-27T18:20:57.644Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

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

post

기능설명

• 사이트 기준으로 약관/이용안내 다국어 정보를 등록 및 수정하는 API 입니다.

---

상세설명

• 입력 파라미터( * : 필수)

  • update : cmAgmtSeq *, langCd *, title *, wrdCont *

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

공통약관정책정보

siteNostringOptional

사이트번호

Example: 1

langCdstringOptional

언어코드(CM009)

Example: ko

cmAgmtSeqstringOptional

공통약관순번

Example: 10202

siteNmstringOptional

사이트명

Example: x2bee

cmAgmtPolcGbCdstringOptional

공통약관정책구분코드(CH010)

Example: 300

cmAgmtGbNmstringOptional

약관정책구분명

Example: 개인정보처리방침

agmtPolcCdstringOptional

약관정책코드(CH005)

Example: 300

agmtPolcNmstringOptional

약관정책코드명

Example: 개인정보처리방침

aplyStrDtstringOptional

적용시작일자

Example: 20230101

aplyEndDtstringOptional

적용종료일자

Example: 20231231

titlestringOptional

제목

Example: 약관정책코드제목

wrdContstringOptional

문구내용

Example: 약관정책코드 문구내용

titleOtherstringOptional

제목

Example: 약관정책코드제목

wrdContOtherstringOptional

문구내용

Example: 약관정책코드 문구내용

Responses

200

약관/이용안내 다국어 정보 등록/수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

약관/이용안내 다국어 정보 등록/수정 실패

*/*

post

/v2/display/termsConditionsMgmt/multiLang

HTTPcURLJavaScriptPython

POST /api/bo/v2/display/termsConditionsMgmt/multiLang HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 389

{
  "siteNo": 1,
  "langCd": "ko",
  "cmAgmtSeq": 10202,
  "siteNm": "x2bee",
  "cmAgmtPolcGbCd": 300,
  "cmAgmtGbNm": "개인정보처리방침",
  "agmtPolcCd": 300,
  "agmtPolcNm": "개인정보처리방침",
  "aplyStrDt": 20230101,
  "aplyEndDt": 20231231,
  "title": "약관정책코드제목",
  "wrdCont": "약관정책코드 문구내용",
  "titleOther": "약관정책코드제목",
  "wrdContOther": "약관정책코드 문구내용"
}

{
  "timestamp": "2026-02-27T18:20:57.644Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

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

get

기능설명

• 약관/이용안내 상세정보를 조회하는 API 입니다.

---

상세설명

• 공통약관순번으로 해당 약관/이용안내 상세정보를 조회합니다.

---

수정번호

• Release v1.05_231204 : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cmAgmtSeqstringRequired

공통약관순번

Example: 10202

Responses

200

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

*/*

공통약관정책정보

siteNostringOptional

사이트번호

Example: 1

langCdstringOptional

언어코드(CM009)

Example: ko

cmAgmtSeqstringOptional

공통약관순번

Example: 10202

siteNmstringOptional

사이트명

Example: x2bee

cmAgmtPolcGbCdstringOptional

공통약관정책구분코드(CH010)

Example: 300

cmAgmtGbNmstringOptional

약관정책구분명

Example: 개인정보처리방침

agmtPolcCdstringOptional

약관정책코드(CH005)

Example: 300

agmtPolcNmstringOptional

약관정책코드명

Example: 개인정보처리방침

aplyStrDtstringOptional

적용시작일자

Example: 20230101

aplyEndDtstringOptional

적용종료일자

Example: 20231231

titlestringOptional

제목

Example: 약관정책코드제목

wrdContstringOptional

문구내용

Example: 약관정책코드 문구내용

titleOtherstringOptional

제목

Example: 약관정책코드제목

wrdContOtherstringOptional

문구내용

Example: 약관정책코드 문구내용

900

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

*/*

get

/v2/display/termsConditionsMgmt/{cmAgmtSeq}

HTTPcURLJavaScriptPython

GET /api/bo/v2/display/termsConditionsMgmt/{cmAgmtSeq}?cmAgmtSeq=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "siteNo": 1,
  "langCd": "ko",
  "cmAgmtSeq": 10202,
  "siteNm": "x2bee",
  "cmAgmtPolcGbCd": 300,
  "cmAgmtGbNm": "개인정보처리방침",
  "agmtPolcCd": 300,
  "agmtPolcNm": "개인정보처리방침",
  "aplyStrDt": 20230101,
  "aplyEndDt": 20231231,
  "title": "약관정책코드제목",
  "wrdCont": "약관정책코드 문구내용",
  "titleOther": "약관정책코드제목",
  "wrdContOther": "약관정책코드 문구내용"
}

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

get

기능설명

• 약관/이용안내 다국어 상세정보를 조회하는 API 입니다.

---

상세설명

• 공통약관순번으로 해당 약관/이용안내 다국어 상세정보를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cmAgmtSeqstringRequired

공통약관순번

Example: 10202

langCdstringRequired

언어코드

Example: en

Responses

200

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

*/*

공통약관정책정보

siteNostringOptional

사이트번호

Example: 1

langCdstringOptional

언어코드(CM009)

Example: ko

cmAgmtSeqstringOptional

공통약관순번

Example: 10202

siteNmstringOptional

사이트명

Example: x2bee

cmAgmtPolcGbCdstringOptional

공통약관정책구분코드(CH010)

Example: 300

cmAgmtGbNmstringOptional

약관정책구분명

Example: 개인정보처리방침

agmtPolcCdstringOptional

약관정책코드(CH005)

Example: 300

agmtPolcNmstringOptional

약관정책코드명

Example: 개인정보처리방침

aplyStrDtstringOptional

적용시작일자

Example: 20230101

aplyEndDtstringOptional

적용종료일자

Example: 20231231

titlestringOptional

제목

Example: 약관정책코드제목

wrdContstringOptional

문구내용

Example: 약관정책코드 문구내용

titleOtherstringOptional

제목

Example: 약관정책코드제목

wrdContOtherstringOptional

문구내용

Example: 약관정책코드 문구내용

900

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

*/*

get

/v2/display/termsConditionsMgmt/multiLang/{cmAgmtSeq}

HTTPcURLJavaScriptPython

GET /api/bo/v2/display/termsConditionsMgmt/multiLang/{cmAgmtSeq}?cmAgmtSeq=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "siteNo": 1,
  "langCd": "ko",
  "cmAgmtSeq": 10202,
  "siteNm": "x2bee",
  "cmAgmtPolcGbCd": 300,
  "cmAgmtGbNm": "개인정보처리방침",
  "agmtPolcCd": 300,
  "agmtPolcNm": "개인정보처리방침",
  "aplyStrDt": 20230101,
  "aplyEndDt": 20231231,
  "title": "약관정책코드제목",
  "wrdCont": "약관정책코드 문구내용",
  "titleOther": "약관정책코드제목",
  "wrdContOther": "약관정책코드 문구내용"
}