사용자 정보 관리

사용자 목록 조회

get

기능설명

• 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.

---

상세설명

• 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sysGbCdstringOptional

시스템 구분 코드

jobGrpCdstringOptional

업무 그룹 코드

userInfoSearchTgtstringOptional

사용자 정보 검색 타입

userInfostringOptional

사용자 정보(이름 or 아이디)

useYnstringOptional

사용여부

workStatCdstringOptional

부서코드

indInfoDealYnstringOptional

근무상태코드

pwdLockYnstringOptional

계정 잠김 여부

pageIdxstringRequired

현재 페이지

Example: 1

rowsPerPagestringRequired

페이지 당 row

Example: 10

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/system/userMgmt

HTTPcURLJavaScriptPython

GET /api/bo/v2/system/userMgmt?userListRequest=[object+Object]&pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "userId": "x2bee12",
        "userNm": "홍길동",
        "rcntUseDtm": "2023-09-12 00:00:00",
        "orgTypNm": 11,
        "deptNm": "개발팀",
        "ocpNm": "사원",
        "workStatNm": "01",
        "pwdLockYn": "Y",
        "indInfoDealYn": "Y",
        "useYn": "Y",
        "sysGbCdNm": "백오피스",
        "rtGrpNm": "고객센터",
        "totalCount": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

사용자 저장

post

기능설명

• 사용자 정보를 저장합니다.

---

상세설명

• 사용자를 새로 등록하거나 기존 사용자 정보를 수정합니다.

• 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다

• 필수 값 목록

  • 사용자 아이디

  • 사용자 이름

  • 휴대폰 번호

  • 권한 그룹 번호

  • 이메일 주소

  • 업무 그룹 코드

  • 직책 코드

  • 근무 상태 코드

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

사용자 저장 Request DTO

changeRtGrpNoYnstring · min: 1Required

권한그룹 변경 여부

createYnstring · min: 1Required

신규 등록 여부

beforeRtGrpNostringOptional

변경전 권한그룹번호

rtGrpChgCausContstringOptional

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/system/userMgmt

HTTPcURLJavaScriptPython

POST /api/bo/v2/system/userMgmt HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 693

{
  "userInfo": {
    "userId": "text",
    "userNm": "text",
    "empNo": "text",
    "pwd": "text",
    "userGbCd": "text",
    "rtGrpNo": "text",
    "jobGrpCd": "SYSTEM_MANAGER",
    "ocpCd": "text",
    "workStatCd": "text",
    "deptCd": "text",
    "entrNo": "text",
    "telRgnNo": "text",
    "telTxnoNo": "text",
    "telEndNo": "text",
    "cellSctNo": "text",
    "cellTxnoNo": "text",
    "cellEndNo": "text",
    "cnslEntpNm": "text",
    "ctiNo": "text",
    "itelNo": "text",
    "emailAddr": "text",
    "indInfoDealYn": "text",
    "useYn": "text",
    "atchFileRouteNm": "text",
    "atchFileNm": "text",
    "indInfoDealCausCont": "text",
    "userIpAddr": "text"
  },
  "individualInfoRightList": [
    {
      "userId": "text",
      "indInfoGbCd": "text",
      "useYn": "text"
    }
  ],
  "changeRtGrpNoYn": "text",
  "createYn": "text",
  "beforeRtGrpNo": "text",
  "rtGrpChgCausCont": "text"
}

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

비밀번호 초기화

post

기능설명

• 사용자의 비밀번호를 초기화합니다.

---

상세설명

• 비밀번호는 랜덤한 값으로 변경됩니다.

• 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

userIdstringRequired

사용자 아이디

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/system/userMgmt/{userId}/password/reset

HTTPcURLJavaScriptPython

POST /api/bo/v2/system/userMgmt/{userId}/password/reset?userId=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

비밀번호 초기화

post

기능설명

• 사용자의 비밀번호를 초기화합니다.

---

상세설명

• 비밀번호는 랜덤한 값으로 변경됩니다.

• 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

userIdstringOptional

사용자 아이디

Body

application/json

stringOptional

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/system/userMgmt/modifyInitializePassword

HTTPcURLJavaScriptPython

POST /api/bo/v1/system/userMgmt/modifyInitializePassword HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"

No content

비밀번호 잠김 해제

get

기능설명

• 비밀번호가 잠김을 해제 처리합니다.

---

상세설명

• 비밀번호가 잠겨있는 사용자의 대해 비밀번호 잠김을 해제합니다.

• 비밀번호 실패횟수를 0으로 초기화합니다.

• 업데이트된 사용자 정보를 반환합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

userIdstringRequired

사용자 아이디

Responses

200

성공

*/*

사용자 정보 Response DTO

900

업무처리 오류 내용

*/*

get

/v2/system/userMgmt/modifyUpdatePwdUnlock

HTTPcURLJavaScriptPython

GET /api/bo/v2/system/userMgmt/modifyUpdatePwdUnlock?userId=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "userInfo": {
    "userId": "x2bee12",
    "userGbCd": 10,
    "deptCd": 10001,
    "deptNm": "EC솔루션개발팀",
    "entrNo": 100001,
    "entrNm": "플래티어 협력사",
    "userNm": "홍길동",
    "pwd": "password",
    "sysGbCd": 11,
    "rtGrpNo": 10001,
    "rtGrpNm": "고객센터",
    "useYn": "Y",
    "telRgnNo": "02",
    "telTxnoNo": 123,
    "telEndNo": 5678,
    "cellSctNo": "010",
    "cellTxnoNo": 1234,
    "cellEndNo": 4567,
    "emailAddr": "[e-mail]",
    "indInfoDealYn": "Y",
    "indInfoDealCausCont": "사유",
    "empNo": 10001,
    "jobGrpCd": 11,
    "ocpCd": "01",
    "workStatCd": "01",
    "atchFileRouteNm": "text",
    "atchFileNm": "text",
    "useStrtDt": 20230101,
    "useEndDt": 29991231,
    "cnslEntpNm": "구글",
    "itelNo": "02000000",
    "ctiNo": "ctiid",
    "rcntUseDtm": "2023-01-01 12:30:00.123456",
    "pwdLockRvcmnId": "2023-01-01 12:30:00.123456",
    "pwdLockRvcDtm": "2023-01-01 12:30:00.123456",
    "pwdCntnFailCnt": 0,
    "lstPwdChgDtm": "2023-01-01 12:30:00.123456",
    "pwdLockYn": "N",
    "pwdIniYn": "N",
    "userIpAddr": "127.0.0.1"
  },
  "individualInfoRightList": [
    {
      "userId": "x2bee",
      "indInfoGbCd": "01",
      "useYn": "Y"
    }
  ]
}

사용자 권한그룹 목록 조회

get

기능설명

• 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.

---

상세설명

• 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.

---

수정번호

• Release v2.00_240927 : 사용자 권한그룹 목록 조회 v2 신규 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sysGbCdstringOptional

사스템 구분 코드

rtGrpNmstringOptional

권한 그룹명

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/system/userMgmt/getUserRightGroupInfo

HTTPcURLJavaScriptPython

GET /api/bo/v2/system/userMgmt/getUserRightGroupInfo?userRightGroupRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "rtGrpNo": 10001,
      "sysGbNm": "백오피스",
      "rtGrpNm": "시스템 관리자",
      "sysGbCd": "text",
      "aplyStrDt": 20230101,
      "aplyEndDt": 20230101
    }
  ]
}

사용자 상세 조회

get

기능설명

• 사용자의 정보를 조회합니다.

---

상세설명

• 현재 로그인한 사용자의 정보를 조회합니다.

• 현재 로그인한 사용자의 개인정보 취급권한 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

userIdstringRequired

사용자 아이디

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/system/userMgmt/detail

HTTPcURLJavaScriptPython

GET /api/bo/v2/system/userMgmt/detail?userId=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "userInfo": {
      "userId": "x2bee12",
      "userGbCd": 10,
      "deptCd": 10001,
      "deptNm": "EC솔루션개발팀",
      "entrNo": 100001,
      "entrNm": "플래티어 협력사",
      "userNm": "홍길동",
      "pwd": "password",
      "sysGbCd": 11,
      "rtGrpNo": 10001,
      "rtGrpNm": "고객센터",
      "useYn": "Y",
      "telRgnNo": "02",
      "telTxnoNo": 123,
      "telEndNo": 5678,
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 4567,
      "emailAddr": "[e-mail]",
      "indInfoDealYn": "Y",
      "indInfoDealCausCont": "사유",
      "empNo": 10001,
      "jobGrpCd": 11,
      "ocpCd": "01",
      "workStatCd": "01",
      "atchFileRouteNm": "text",
      "atchFileNm": "text",
      "useStrtDt": 20230101,
      "useEndDt": 29991231,
      "cnslEntpNm": "구글",
      "itelNo": "02000000",
      "ctiNo": "ctiid",
      "rcntUseDtm": "2023-01-01 12:30:00.123456",
      "pwdLockRvcmnId": "2023-01-01 12:30:00.123456",
      "pwdLockRvcDtm": "2023-01-01 12:30:00.123456",
      "pwdCntnFailCnt": 0,
      "lstPwdChgDtm": "2023-01-01 12:30:00.123456",
      "pwdLockYn": "N",
      "pwdIniYn": "N",
      "userIpAddr": "127.0.0.1"
    },
    "individualInfoRightList": [
      {
        "userId": "x2bee",
        "indInfoGbCd": "01",
        "useYn": "Y"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

사용자 아이디 중복체크

get

기능설명

• 사용자 아이디 개수를 조회합니다.

---

상세설명

• 파라미터 값과 현재 저장되어 있는 사용자 아이디를 비교하여 일치하는 개수를 반환합니다.

• 아이디 중복 체크를 위해 사용됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

userIdstringOptional

사용자 아이디

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadinteger · int32Optional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/system/userMgmt/check

HTTPcURLJavaScriptPython

GET /api/bo/v2/system/userMgmt/check HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:00.760Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": 1,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

사용자 권한그룹 목록 건수 조회

get

기능설명

• 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.

---

상세설명

• 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sysGbCdstringOptional

사스템 구분 코드

rtGrpNmstringOptional

권한 그룹명

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/system/userMgmt/getUserRightGroupListCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/system/userMgmt/getUserRightGroupListCount?userRightGroupRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

사용자 권한그룹 목록 조회

get

기능설명

• 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.

---

상세설명

• 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sysGbCdstringOptional

사스템 구분 코드

rtGrpNmstringOptional

권한 그룹명

Responses

200

성공

*/*

권한그룹 정보 Response DTO

rtGrpNostringOptional

권한그룹번호

Example: 10001

sysGbNmstringOptional

시스템구분명

Example: 백오피스

rtGrpNmstringOptional

권한그룹명

Example: 시스템 관리자

sysGbCdstringOptional

시스템구분코드(UR005)

aplyStrDtstringOptional

적용시작일자

Example: 20230101

aplyEndDtstringOptional

적용종료일자

Example: 20230101

900

업무처리 오류 내용

*/*

get

/v1/system/userMgmt/getUserRightGroupInfo

HTTPcURLJavaScriptPython

GET /api/bo/v1/system/userMgmt/getUserRightGroupInfo?userRightGroupRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "rtGrpNo": 10001,
    "sysGbNm": "백오피스",
    "rtGrpNm": "시스템 관리자",
    "sysGbCd": "text",
    "aplyStrDt": 20230101,
    "aplyEndDt": 20230101
  }
]

사용자 목록 수 조회

get

기능설명

• 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.

---

상세설명

• 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sysGbCdstringOptional

시스템 구분 코드

jobGrpCdstringOptional

업무 그룹 코드

userInfoSearchTgtstringOptional

사용자 정보 검색 타입

userInfostringOptional

사용자 정보(이름 or 아이디)

useYnstringOptional

사용여부

workStatCdstringOptional

부서코드

indInfoDealYnstringOptional

근무상태코드

pwdLockYnstringOptional

계정 잠김 여부

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/system/userMgmt/getUserListInUserMenuCount

HTTPcURLJavaScriptPython

GET /api/bo/v1/system/userMgmt/getUserListInUserMenuCount?userListRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

사용자 개인정보 취급권한 조회

get

기능설명

• 사용자의 개인정보 취급권한 목록을 조회합니다.

---

상세설명

• 현재 로그인한 사용자의 개인정보 취급권한 목록을 조회합니다.

• 사용 여부가 Y인 목록을 조회합니다. --

수정번호

• Release v2.00_240912: 최초 개발

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

개인정보취급권한 DTO

userIdstringOptional

사용자 아이디

Example: x2bee

indInfoGbCdstringOptional

개인정보구분코드(UR008)

Example: 01

useYnstringOptional

사용여부

Example: Y

900

업무처리 오류 내용

*/*

get

/v1/system/userMgmt/getIndividualInfoRightList

HTTPcURLJavaScriptPython

GET /api/bo/v1/system/userMgmt/getIndividualInfoRightList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "userId": "x2bee",
    "indInfoGbCd": "01",
    "useYn": "Y"
  }
]