공통

권한대상 사용로그 등록

post

기능설명

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

상세설명

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

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

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-01-01T00:00:00.000Z",
  "rtGrpNo": "text",
  "callUrl": "text",
  "prmtInfo": "text",
  "ipAddr": "text",
  "sysRegId": "text",
  "sysRegDtm": "2026-01-01T00:00:00.000Z"
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

URL 권한 조회

post

기능설명

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

상세설명

화면 호출 URL 에 대한 사용자의 권한이 있는지를 조회합니다.
조회할 수 있는 권한이 있을 시 0보다 큰 건 수를 반환합니다.
아이디에 대한 시스템구분코드에 맞는 권한을 조회합니다.
권한이 없을 시 (결과 = 0) 화면 URL에 대한 권한이 없는 것으로 판단합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

accountNonExpiredbooleanOptional

accountNonLockedbooleanOptional

credentialsNonExpiredbooleanOptional

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

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"
    }
  ],
  "accountNonExpired": true,
  "accountNonLocked": true,
  "credentialsNonExpired": true,
  "permissionToViewPersonalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "username": "text",
  "name": "text",
  "enabled": true
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "rtTgtSeq": "text",
    "rtTgtNm": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

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

post

기능 설명

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

상세 내용

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

Authorizations

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

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-01-01T00:00:00.000Z",
  "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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pmsCdstringRequired

권한코드

Example: 01

Responses

200

성공

*/*

booleanOptional

900

업무처리 오류 내용

*/*

get/v1/common/common/hasListExcelDownloadPermission

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

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

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-01-01T00:00:00.000Z",
  "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

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

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=

이전고객센터 대시보드 다음공통코드 조회

마지막 업데이트 3일 전