공통코드 조회

공통코드 타입별 조회

post

기능설명

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

---

상세설명

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

• 조회타입 별 조회 방식

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

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

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

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

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

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

---

코드정리

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject[]

application/json

공통코드 조회 요청 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

900

업무처리 오류 내용

*/*

post

/v1/common/code/getForwardCdCdNmByMixedCode

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "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

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

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/common/code/getEnabledButtonByPageRoleList

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

권한 없는 저장버튼 조회

post

기능설명

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

---

상세설명

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

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

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

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/common/code/getButtonByUserList

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "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

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

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/common/code/getButtonByPageRoleList

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

공통코드 조회

get

기능설명

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

---

상세설명

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

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

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

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

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

Authorizations

accessToken

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

900

업무처리 오류 내용

*/*

get

/v1/common/code/getStStdCd

HTTPcURLJavaScriptPython

GET /api/bo/v1/common/code/getStStdCd HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:21:08.687Z",
  "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

accessToken

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

900

업무처리 오류 내용

*/*

get

/v1/common/code/getStStdCdByDataLangCd

HTTPcURLJavaScriptPython

GET /api/bo/v1/common/code/getStStdCdByDataLangCd HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:21:08.687Z",
  "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

accessToken

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

900

업무처리 오류 내용

*/*

get

/v1/common/code/getReverseStStdCd

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "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

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/code/getForwardCdCdNmFromStStdCdByGrpCdRef1Val

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "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

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/code/getCdCdNmFromStStdCdByGrpCdOrderRef3Val

HTTPcURLJavaScriptPython

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-02-27T18:21:08.687Z",
  "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"
    }
  ]
}