Ctrlk
X2BEE 바로가기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

공통코드 조회

공통코드 타입별 조회

post

기능설명

  • 공통코드를 조회 타입별로 조회합니다.

상세설명

  • 공통코드를 넘어온 조회 타입(type) 기준으로 조회합니다.

  • 조회타입 별 조회 방식

    • T(테이블 조회), code, 'SITE', referCode : CC_SITE_BASE : 사이트번호, 사이트명 조회

    • NC(노멀 타입 조회) : 일반 공통코드 순차조회

    • NMC(노멀 멀티 조회) : 일반 공통코드 순차조회

    • RC(참조값 기준 조회) : 참조1값 기준 공통코드 조회

  • 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.

  • 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.

코드정리

  • 조회타입 : T(테이블 조회), NC(노멀 타입 조회), NMC(노멀 멀티 조회), RC(참조값 기준 조회)

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Bodyobject · CodeReqDto[]

공통코드 조회 요청 DTO

codestringOptional

그룹코드

Example: ME001
referCodestringOptional

참조코드

Example: 1
typestringOptional

조회타입

Example: NC
grpCdsstringOptional

그룹코드

Example: ME001,ME002
langCdstringOptional

언어코드

Example: ko
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

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

[
  {
    "code": "ME001",
    "referCode": 1,
    "type": "NC",
    "grpCds": "ME001,ME002",
    "langCd": "ko"
  }
]
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "key": "GRP_CD",
        "cd": "ME001",
        "cdNm": "회원유형코드",
        "ref1Val": 1,
        "ref2Val": 1,
        "ref3Val": 1,
        "ref4Val": 1,
        "ref5Val": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

권한 존재 버튼 조회

post

기능설명

  • 화면에 대한 권한을 가진 버튼 ID를 조회합니다.

상세설명

  • 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 가능한 버튼ID를 반환합니다.

  • '버튼ID,버튼ID' 형태로 반환합니다.

  • 개별 권한을 그룹 권한보다 우선하여 조회합니다.(예: 개별권한 'N', 그룹권한 'Y'시 접근권한으로 'N' 반환

수정번호

  • Release v1.00_250320: 권한 존재 버튼 목록 화이트리스트로 변경

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
credentialsNonExpiredbooleanOptional
accountNonExpiredbooleanOptional
accountNonLockedbooleanOptional
usernamestringOptional
namestringOptional
enabledbooleanOptional
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/common/code/getEnabledButtonByPageRoleList
POST /api/bo/v1/common/code/getEnabledButtonByPageRoleList 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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

권한 없는 저장버튼 조회

post

기능설명

  • 화면에 대한 저장 권한이 없는 버튼 ID를 조회합니다.

상세설명

  • 호출URL과 시스템구분코드에 맞는 데이터 저장에 관한 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.

  • '#버튼ID,#버튼ID' 형태로 반환합니다.

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
credentialsNonExpiredbooleanOptional
accountNonExpiredbooleanOptional
accountNonLockedbooleanOptional
usernamestringOptional
namestringOptional
enabledbooleanOptional
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/common/code/getButtonByUserList
POST /api/bo/v1/common/code/getButtonByUserList 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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

권한 없는 버튼 조회

post

기능설명

  • 화면에 대한 권한이 없는 버튼 ID를 조회합니다.

상세설명

  • 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.

  • '#버튼ID,#버튼ID' 형태로 반환합니다.

수정번호

  • Release v2.00_240711: 그룹 권한과 개별 권한이 모두 없는 버튼 ID만 조회하도록 변경

  • Release v2.01_250314: 개별 권한을 그룹 권한보다 우선하여 조회하도록 변경

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
credentialsNonExpiredbooleanOptional
accountNonExpiredbooleanOptional
accountNonLockedbooleanOptional
usernamestringOptional
namestringOptional
enabledbooleanOptional
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/common/code/getButtonByPageRoleList
POST /api/bo/v1/common/code/getButtonByPageRoleList 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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

공통코드 조회

get

기능설명

  • 공통코드를 조회합니다.

상세설명

  • 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.

  • 사용여부가 Y인 공통코드 목록을 조회합니다.

  • 코드의 정렬순서 기준 순차적으로 조회합니다.

  • 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.

  • 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
grpCdsstringOptional
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v1/common/code/getStStdCd
GET /api/bo/v1/common/code/getStStdCd 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": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "grpCd": "ME001",
        "cd": 11,
        "cdNm": "상품즉시할인",
        "cdDesc": "다국어 코드설명",
        "useYn": "Y",
        "sortSeq": 1,
        "ref1Val": "기준코드 참조1값에 대한 설명",
        "ref2Val": "기준코드 참조2값에 대한 설명",
        "ref3Val": "기준코드 참조3값에 대한 설명",
        "ref4Val": "기준코드 참조4값에 대한 설명",
        "ref5Val": "기준코드 참조5값에 대한 설명",
        "ref6Val": "기준코드 참조6값에 대한 설명",
        "ref7Val": "기준코드 참조7값에 대한 설명"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

GNB 언어기준 공통코드 조회

get

기능설명

  • 공통코드를 조회합니다.

상세설명

  • 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.

  • 사용여부가 Y인 공통코드 목록을 조회합니다.

  • 코드의 정렬순서 기준 순차적으로 조회합니다.

  • 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.

  • 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 dataLangCd 기준으로 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
grpCdsstringOptional
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v1/common/code/getStStdCdByDataLangCd
GET /api/bo/v1/common/code/getStStdCdByDataLangCd 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": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "grpCd": "ME001",
        "cd": 11,
        "cdNm": "상품즉시할인",
        "cdDesc": "다국어 코드설명",
        "useYn": "Y",
        "sortSeq": 1,
        "ref1Val": "기준코드 참조1값에 대한 설명",
        "ref2Val": "기준코드 참조2값에 대한 설명",
        "ref3Val": "기준코드 참조3값에 대한 설명",
        "ref4Val": "기준코드 참조4값에 대한 설명",
        "ref5Val": "기준코드 참조5값에 대한 설명",
        "ref6Val": "기준코드 참조6값에 대한 설명",
        "ref7Val": "기준코드 참조7값에 대한 설명"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

공통코드 역순 조회

get

기능설명

  • 공통코드를 역순으로 조회합니다.

상세설명

  • 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.

  • 사용여부가 Y인 공통코드 목록을 조회합니다.

  • 코드의 정렬순서 기준 역순으로 조회합니다.

  • 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.

  • 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
grpCdsstringRequired

그룹코드문자열

Example: ME001,ME002
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v1/common/code/getReverseStStdCd
GET /api/bo/v1/common/code/getReverseStStdCd?grpCds=text 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": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "grpCd": "ME001",
        "cd": 11,
        "cdNm": "상품즉시할인",
        "cdDesc": "다국어 코드설명",
        "useYn": "Y",
        "sortSeq": 1,
        "ref1Val": "기준코드 참조1값에 대한 설명",
        "ref2Val": "기준코드 참조2값에 대한 설명",
        "ref3Val": "기준코드 참조3값에 대한 설명",
        "ref4Val": "기준코드 참조4값에 대한 설명",
        "ref5Val": "기준코드 참조5값에 대한 설명",
        "ref6Val": "기준코드 참조6값에 대한 설명",
        "ref7Val": "기준코드 참조7값에 대한 설명"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

참조1값 기준 공통코드 조회

get

기능설명

  • 참조1값 기준으로 공통코드 목록을 조회합니다.

상세설명

  • 코드가 가진 참조1값을 기준으로 공통코드 목록을 조회합니다.

  • 사용여부가 Y인 공통코드 목록을 조회합니다.

  • 참조코드(referCode), 코드(code)는 필수입니다.

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

get/v1/common/code/getForwardCdCdNmFromStStdCdByGrpCdRef1Val
GET /api/bo/v1/common/code/getForwardCdCdNmFromStStdCdByGrpCdRef1Val?params=[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": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "key": "GRP_CD",
        "cd": "ME001",
        "cdNm": "회원유형코드",
        "ref1Val": 1,
        "ref2Val": 1,
        "ref3Val": 1,
        "ref4Val": 1,
        "ref5Val": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

참조3값 기준 공통코드 조회

get

기능설명

  • 참조3값 기준으로 공통코드 목록을 조회합니다.

상세설명

  • 코드가 가진 참조3값을 기준으로 공통코드 목록을 조회합니다.

  • 사용여부가 Y인 공통코드 목록을 조회합니다.

  • 참조코드(referCode), 코드(code)는 필수입니다.

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

get/v1/common/code/getCdCdNmFromStStdCdByGrpCdOrderRef3Val
GET /api/bo/v1/common/code/getCdCdNmFromStStdCdByGrpCdOrderRef3Val?params=[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": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "key": "GRP_CD",
        "cd": "ME001",
        "cdNm": "회원유형코드",
        "ref1Val": 1,
        "ref2Val": 1,
        "ref3Val": 1,
        "ref4Val": 1,
        "ref5Val": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}
이전공통
다음AI 사용 집계

마지막 업데이트