공통

권한대상 사용로그 등록

post

기능설명

• 접속한 URL에 대한 권한대상 사용로그를 등록합니다.

---

상세설명

• 접속한 URL에 대한 사용자의 권한대상 사용로그를 등록합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

userIdstringOptional

rtTgtSeqstringOptional

workDtmstring · date-timeOptional

rtGrpNostringOptional

callUrlstringOptional

prmtInfostringOptional

ipAddrstringOptional

sysRegIdstringOptional

sysRegDtmstring · date-timeOptional

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/common/common/insertStRtTgtBaseLog

HTTPcURLJavaScriptPython

POST /api/bo/v1/common/common/insertStRtTgtBaseLog HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 197

{
  "userId": "text",
  "rtTgtSeq": "text",
  "workDtm": "2026-02-27T18:20:50.124Z",
  "rtGrpNo": "text",
  "callUrl": "text",
  "prmtInfo": "text",
  "ipAddr": "text",
  "sysRegId": "text",
  "sysRegDtm": "2026-02-27T18:20:50.124Z"
}

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

URL 권한 조회

post

기능설명

• 화면 URL 에 대한 권한을 조회합니다.

---

상세설명

• 화면 호출 URL 에 대한 사용자의 권한이 있는지를 조회합니다.

• 조회할 수 있는 권한이 있을 시 0보다 큰 건 수를 반환합니다.

• 아이디에 대한 시스템구분코드에 맞는 권한을 조회합니다.

• 권한이 없을 시 (결과 = 0) 화면 URL에 대한 권한이 없는 것으로 판단합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

seqinteger · int64Optional

loginIdstring · min: 1Required

passwordstringOptional

remoteAddrstringOptional

lastAccessTimeinteger · int64Optional

userGbCdstringOptional

rtGrpNostringOptional

jobGrpCdstringOptional

ocpCdstringOptional

caloUrlstringOptional

sysGbCdstringOptional

userIdstringOptional

pwdstringOptional

userNmstringOptional

cellSctNostringOptional

cellTxnoNostringOptional

cellEndNostringOptional

pwdIniYnstringOptional

sessIdstringOptional

tpCdstringOptional

entrNostringOptional

entrNmstringOptional

applicationNamestringOptional

credentialsNonExpiredbooleanOptional

accountNonExpiredbooleanOptional

accountNonLockedbooleanOptional

usernamestringOptional

namestringOptional

enabledbooleanOptional

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/common/common/getAdminGroups

HTTPcURLJavaScriptPython

POST /api/bo/v1/common/common/getAdminGroups HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 664

{
  "seq": 1,
  "loginId": "text",
  "password": "text",
  "remoteAddr": "text",
  "lastAccessTime": 1,
  "userGbCd": "text",
  "rtGrpNo": "text",
  "jobGrpCd": "text",
  "ocpCd": "text",
  "caloUrl": "text",
  "sysGbCd": "text",
  "userId": "text",
  "pwd": "text",
  "userNm": "text",
  "cellSctNo": "text",
  "cellTxnoNo": "text",
  "cellEndNo": "text",
  "pwdIniYn": "text",
  "sessId": "text",
  "tpCd": "text",
  "entrNo": "text",
  "entrNm": "text",
  "applicationName": "text",
  "privacyPolicyInfoList": [
    {
      "userId": "x2bee",
      "indInfoGbCd": "01",
      "useYn": "Y"
    }
  ],
  "credentialsNonExpired": true,
  "accountNonExpired": true,
  "accountNonLocked": true,
  "permissionToViewPersonalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "username": "text",
  "name": "text",
  "enabled": true
}

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

웹에디터 이미지 파일 업로드

post

기능 설명

• BO의 웹에디터(WYSIWYG)에서 이미지를 업로드할때 사용되는 API입니다.

---

상세 내용

• 전달받은 이미지 데이터를 저장하고, url 경로를 돌려줍니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filesstring · binaryRequired

이미지 파일 목록

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/common/common/file/uploadImgEditor

HTTPcURLJavaScriptPython

POST /api/bo/v1/common/common/file/uploadImgEditor?files=binary HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:20:50.124Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "statusCode": "text",
      "statusMsg": "text",
      "orgFileName": "text",
      "fileName": "text",
      "url": "text",
      "path": "text",
      "size": 1,
      "extension": "text",
      "fullPath": "text",
      "tempFullPath": "text",
      "typeCd": "text",
      "multipartFile": "binary"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

엑셀 다운로드 권한 체크

get

기능 설명

• BO 사용자에게 엑셀 다운로드의 권한이 있는지 체크하는 API입니다.

---

상세 내용

• 엑셀 다운로드 시 사용자에게 권한이 있는지 확인합니다.

• 체크할 권한에 대한 세부 사항은 권한코드에 따라 다르게 설정합니다.

• 01 : ID/이름/휴대폰번호 체크 (이벤트 상세 > 응모/추첨/지급관리 엑셀 다운로드 권한 & 이벤트 사은품 배송관리 엑셀 다운로드 권한)

• 02 : ID/이름/고객계좌번호 체크 (수기 환불완료 관리 > 일괄 환불처리 엑셀 다운로드 권한)

• 03 : 이름/전화번호/이메일 체크 (증빙서류 신청 관리 > 증빙서류 확인 권한)

수정 번호

     * Release v2.01_240923 : 권한코드 타입 추가(02:ID/이름/고객계좌번호 체크)
     * Release v2.01_251020 : 권한코드 타입 추가(03:이름/전화번호/이메일 체크)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pmsCdstringRequired

권한코드

Example: 01

Responses

200

성공

*/*

booleanOptional

900

업무처리 오류 내용

*/*

get

/v1/common/common/hasListExcelDownloadPermission

HTTPcURLJavaScriptPython

GET /api/bo/v1/common/common/hasListExcelDownloadPermission?permissionCodeRequest=[object+Object]&pmsCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

true

접속한 URL의 권한 정보 및 개인정보 유무 조회

get

기능설명

• 접속 URL에 대한 사용자의 권한 정보와 개인정보 유무를 조회합니다.

---

상세설명

• 접속 URL에 대한 사용자의 권한 정보와 개인정보 유무를 조회합니다.

• 아이디에 대한 시스템구분코드에 맞는 권한을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v1/common/common/getRtTgtSeqByStRtTgtBase

HTTPcURLJavaScriptPython

GET /api/bo/v1/common/common/getRtTgtSeqByStRtTgtBase?stRtTgtBase=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:20:50.124Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "rtTgtSeq": 1100127,
    "sysGbCd": 11,
    "rtTgtTypCd": 20,
    "rtTgtNm": "공통팝업-사용자조회",
    "sortSeq": 1,
    "callUrl": "popup/userMgmtPopup.userListPopup.do",
    "useYn": "Y",
    "custInfoInclYn": "Y",
    "rmkCont": "비고내용",
    "popupYn": "Y",
    "btnId": "btn_kakaoTalk",
    "uprRtTgtSeq": 1105686,
    "leafMenuYn": "Y",
    "userHelpCont": "사용자도움말내용"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

저장소 파일 다운로드

get

기능 설명

• 저장소에 저장된 데이터를 직접 다운로드합니다.

---

상세 내용

• 일반적으로 접근이 불가능한 경우에도 서버를 통해 다운로드가 가능한 기능을 지원합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

fullPathfullPathRequired

저장소 파일경로

Example: file/2024/09/04/test

originalFileNameoriginalFileNameRequired

원본 파일명

Example: test.xls

Responses

200

성공

*/*

string · byteOptional

900

업무처리 오류 내용

*/*

get

/v1/common/common/downloadFile

HTTPcURLJavaScriptPython

GET /api/bo/v1/common/common/downloadFile?fullPath=null&originalFileName=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

Ynl0ZXM=