# 공통코드 조회
## 공통코드 타입별 조회
> \## 기능설명\
> \* 공통코드를 조회 타입별로 조회합니다.\
> \---\
> \## 상세설명\
> \* 공통코드를 넘어온 조회 타입(type) 기준으로 조회합니다.\
> \* 조회타입 별 조회 방식\
> \* T(테이블 조회), code, 'SITE', referCode : CC\_SITE\_BASE : 사이트번호, 사이트명 조회\
> \* NC(노멀 타입 조회) : 일반 공통코드 순차조회\
> \* NMC(노멀 멀티 조회) : 일반 공통코드 순차조회\
> \* RC(참조값 기준 조회) : 참조1값 기준 공통코드 조회\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\
> \---\
> \### 코드정리\
> \* \`\`\` 조회타입 \`\`\` : T(테이블 조회), NC(노멀 타입 조회), NMC(노멀 멀티 조회), RC(참조값 기준 조회)
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CodeReqDto":{"type":"object","description":"공통코드 조회 요청 DTO","properties":{"code":{"type":"string","description":"그룹코드"},"referCode":{"type":"string","description":"참조코드"},"type":{"type":"string","description":"조회타입"},"grpCds":{"type":"string","description":"그룹코드"},"langCd":{"type":"string","description":"언어코드"}}},"ResponseMapStringListCodeResDto":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CodeResDto"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CodeResDto":{"type":"object","description":"공통코드 조회 응답 DTO","properties":{"key":{"type":"string","description":"map의 키"},"cd":{"type":"string","description":"그룹코드"},"cdNm":{"type":"string","description":"코드명"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getForwardCdCdNmByMixedCode":{"post":{"tags":["공통코드 조회"],"summary":"공통코드 타입별 조회","description":"## 기능설명\n* 공통코드를 조회 타입별로 조회합니다.\n---\n## 상세설명\n* 공통코드를 넘어온 조회 타입(type) 기준으로 조회합니다.\n* 조회타입 별 조회 방식\n * T(테이블 조회), code, 'SITE', referCode : CC_SITE_BASE : 사이트번호, 사이트명 조회\n * NC(노멀 타입 조회) : 일반 공통코드 순차조회\n * NMC(노멀 멀티 조회) : 일반 공통코드 순차조회\n * RC(참조값 기준 조회) : 참조1값 기준 공통코드 조회\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\n---\n### 코드정리\n* ``` 조회타입 ``` : T(테이블 조회), NC(노멀 타입 조회), NMC(노멀 멀티 조회), RC(참조값 기준 조회)\n","operationId":"getForwardCdCdNmByMixedCode","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CodeReqDto"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListCodeResDto"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## 권한 존재 버튼 조회
> \## 기능설명\
> \* 화면에 대한 권한을 가진 버튼 ID를 조회합니다.\
> \---\
> \## 상세설명\
> \* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 가능한 버튼ID를 반환합니다.\
> \* '버튼ID,버튼ID' 형태로 반환합니다.\
> \* 개별 권한을 그룹 권한보다 우선하여 조회합니다.(예: 개별권한 'N', 그룹권한 'Y'시 접근권한으로 'N' 반환\
> \---\
> \## 수정번호\
> \* Release v1.00\_250320: 권한 존재 버튼 목록 화이트리스트로 변경
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"LoginRequest":{"type":"object","properties":{"seq":{"type":"integer","format":"int64"},"loginId":{"type":"string","minLength":1},"password":{"type":"string"},"remoteAddr":{"type":"string"},"lastAccessTime":{"type":"integer","format":"int64"},"userGbCd":{"type":"string"},"rtGrpNo":{"type":"string"},"jobGrpCd":{"type":"string"},"ocpCd":{"type":"string"},"caloUrl":{"type":"string"},"sysGbCd":{"type":"string"},"userId":{"type":"string"},"pwd":{"type":"string"},"userNm":{"type":"string"},"cellSctNo":{"type":"string"},"cellTxnoNo":{"type":"string"},"cellEndNo":{"type":"string"},"pwdIniYn":{"type":"string"},"sessId":{"type":"string"},"tpCd":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"applicationName":{"type":"string"},"privacyPolicyInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}},"permissionToViewPersonalInfo":{"type":"object","additionalProperties":{}},"username":{"type":"string"},"accountNonExpired":{"type":"boolean"},"accountNonLocked":{"type":"boolean"},"credentialsNonExpired":{"type":"boolean"},"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["loginId"]},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getEnabledButtonByPageRoleList":{"post":{"tags":["공통코드 조회"],"summary":"권한 존재 버튼 조회","description":"## 기능설명\n* 화면에 대한 권한을 가진 버튼 ID를 조회합니다.\n---\n## 상세설명\n* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 가능한 버튼ID를 반환합니다.\n* '버튼ID,버튼ID' 형태로 반환합니다.\n* 개별 권한을 그룹 권한보다 우선하여 조회합니다.(예: 개별권한 'N', 그룹권한 'Y'시 접근권한으로 'N' 반환\n---\n## 수정번호\n* Release v1.00_250320: 권한 존재 버튼 목록 화이트리스트로 변경\n","operationId":"getEnabledButtonByPageRoleList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 권한 없는 저장버튼 조회
> \## 기능설명\
> \* 화면에 대한 저장 권한이 없는 버튼 ID를 조회합니다.\
> \---\
> \## 상세설명\
> \* 호출URL과 시스템구분코드에 맞는 데이터 저장에 관한 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\
> \* '#버튼ID,#버튼ID' 형태로 반환합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"LoginRequest":{"type":"object","properties":{"seq":{"type":"integer","format":"int64"},"loginId":{"type":"string","minLength":1},"password":{"type":"string"},"remoteAddr":{"type":"string"},"lastAccessTime":{"type":"integer","format":"int64"},"userGbCd":{"type":"string"},"rtGrpNo":{"type":"string"},"jobGrpCd":{"type":"string"},"ocpCd":{"type":"string"},"caloUrl":{"type":"string"},"sysGbCd":{"type":"string"},"userId":{"type":"string"},"pwd":{"type":"string"},"userNm":{"type":"string"},"cellSctNo":{"type":"string"},"cellTxnoNo":{"type":"string"},"cellEndNo":{"type":"string"},"pwdIniYn":{"type":"string"},"sessId":{"type":"string"},"tpCd":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"applicationName":{"type":"string"},"privacyPolicyInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}},"permissionToViewPersonalInfo":{"type":"object","additionalProperties":{}},"username":{"type":"string"},"accountNonExpired":{"type":"boolean"},"accountNonLocked":{"type":"boolean"},"credentialsNonExpired":{"type":"boolean"},"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["loginId"]},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getButtonByUserList":{"post":{"tags":["공통코드 조회"],"summary":"권한 없는 저장버튼 조회","description":"## 기능설명\n* 화면에 대한 저장 권한이 없는 버튼 ID를 조회합니다.\n---\n## 상세설명\n* 호출URL과 시스템구분코드에 맞는 데이터 저장에 관한 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\n* '#버튼ID,#버튼ID' 형태로 반환합니다.\n","operationId":"getButtonByUserList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 권한 없는 버튼 조회
> \## 기능설명\
> \* 화면에 대한 권한이 없는 버튼 ID를 조회합니다.\
> \---\
> \## 상세설명\
> \* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\
> \* '#버튼ID,#버튼ID' 형태로 반환합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240711: 그룹 권한과 개별 권한이 모두 없는 버튼 ID만 조회하도록 변경\
> \* Release v2.01\_250314: 개별 권한을 그룹 권한보다 우선하여 조회하도록 변경
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"LoginRequest":{"type":"object","properties":{"seq":{"type":"integer","format":"int64"},"loginId":{"type":"string","minLength":1},"password":{"type":"string"},"remoteAddr":{"type":"string"},"lastAccessTime":{"type":"integer","format":"int64"},"userGbCd":{"type":"string"},"rtGrpNo":{"type":"string"},"jobGrpCd":{"type":"string"},"ocpCd":{"type":"string"},"caloUrl":{"type":"string"},"sysGbCd":{"type":"string"},"userId":{"type":"string"},"pwd":{"type":"string"},"userNm":{"type":"string"},"cellSctNo":{"type":"string"},"cellTxnoNo":{"type":"string"},"cellEndNo":{"type":"string"},"pwdIniYn":{"type":"string"},"sessId":{"type":"string"},"tpCd":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"applicationName":{"type":"string"},"privacyPolicyInfoList":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}},"permissionToViewPersonalInfo":{"type":"object","additionalProperties":{}},"username":{"type":"string"},"accountNonExpired":{"type":"boolean"},"accountNonLocked":{"type":"boolean"},"credentialsNonExpired":{"type":"boolean"},"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["loginId"]},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getButtonByPageRoleList":{"post":{"tags":["공통코드 조회"],"summary":"권한 없는 버튼 조회","description":"## 기능설명\n* 화면에 대한 권한이 없는 버튼 ID를 조회합니다.\n---\n## 상세설명\n* 호출URL과 시스템구분코드에 맞는 권한정보에 대해 접근이 불가능한 버튼ID를 반환합니다.\n* '#버튼ID,#버튼ID' 형태로 반환합니다.\n---\n## 수정번호\n* Release v2.00_240711: 그룹 권한과 개별 권한이 모두 없는 버튼 ID만 조회하도록 변경\n* Release v2.01_250314: 개별 권한을 그룹 권한보다 우선하여 조회하도록 변경\n","operationId":"getButtonByPageRoleList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 공통코드 조회
> \## 기능설명\
> \* 공통코드를 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 코드의 정렬순서 기준 순차적으로 조회합니다.\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseMapStringListStStdCd":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getStStdCd":{"get":{"tags":["공통코드 조회"],"summary":"공통코드 조회","description":"## 기능설명\n* 공통코드를 조회합니다.\n---\n## 상세설명\n* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 코드의 정렬순서 기준 순차적으로 조회합니다.\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\n","operationId":"getStStdCd","parameters":[{"name":"grpCds","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListStStdCd"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## GNB 언어기준 공통코드 조회
> \## 기능설명\
> \* 공통코드를 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 코드의 정렬순서 기준 순차적으로 조회합니다.\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 dataLangCd 기준으로 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseMapStringListStStdCd":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getStStdCdByDataLangCd":{"get":{"tags":["공통코드 조회"],"summary":"GNB 언어기준 공통코드 조회","description":"## 기능설명\n* 공통코드를 조회합니다.\n---\n## 상세설명\n* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 코드의 정렬순서 기준 순차적으로 조회합니다.\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 dataLangCd 기준으로 조회합니다.\n","operationId":"getStStdCdByDataLangCd","parameters":[{"name":"grpCds","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListStStdCd"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 공통코드 역순 조회
> \## 기능설명\
> \* 공통코드를 역순으로 조회합니다.\
> \---\
> \## 상세설명\
> \* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 코드의 정렬순서 기준 역순으로 조회합니다.\
> \* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\
> \* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseMapStringListStStdCd":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getReverseStStdCd":{"get":{"tags":["공통코드 조회"],"summary":"공통코드 역순 조회","description":"## 기능설명\n* 공통코드를 역순으로 조회합니다.\n---\n## 상세설명\n* 넘어온 파라미터를 ',' 기준으로 잘라 해당 그룹코드에 대한 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 코드의 정렬순서 기준 역순으로 조회합니다.\n* 그룹코드, 공통코드 목록 리스트 의 형태인 Map 으로 반환합니다.\n* 조회언어 기준은 기본 세팅된 언어코드인 쿠키의 langCd 기준으로 조회합니다.\n","operationId":"getReverseStStdCd","parameters":[{"name":"grpCds","in":"query","description":"그룹코드문자열","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListStStdCd"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 참조1값 기준 공통코드 조회
> \## 기능설명\
> \* 참조1값 기준으로 공통코드 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 코드가 가진 참조1값을 기준으로 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 참조코드(referCode), 코드(code)는 필수입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CodeReqDto":{"type":"object","description":"공통코드 조회 요청 DTO","properties":{"code":{"type":"string","description":"그룹코드"},"referCode":{"type":"string","description":"참조코드"},"type":{"type":"string","description":"조회타입"},"grpCds":{"type":"string","description":"그룹코드"},"langCd":{"type":"string","description":"언어코드"}}},"ResponseMapStringListCodeResDto":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CodeResDto"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CodeResDto":{"type":"object","description":"공통코드 조회 응답 DTO","properties":{"key":{"type":"string","description":"map의 키"},"cd":{"type":"string","description":"그룹코드"},"cdNm":{"type":"string","description":"코드명"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getForwardCdCdNmFromStStdCdByGrpCdRef1Val":{"get":{"tags":["공통코드 조회"],"summary":"참조1값 기준 공통코드 조회","description":"## 기능설명\n* 참조1값 기준으로 공통코드 목록을 조회합니다.\n---\n## 상세설명\n* 코드가 가진 참조1값을 기준으로 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 참조코드(referCode), 코드(code)는 필수입니다.\n","operationId":"getForwardCdCdNmFromStStdCdByGrpCdRef1Val","parameters":[{"name":"params","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CodeReqDto"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListCodeResDto"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 참조3값 기준 공통코드 조회
> \## 기능설명\
> \* 참조3값 기준으로 공통코드 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 코드가 가진 참조3값을 기준으로 공통코드 목록을 조회합니다.\
> \* 사용여부가 \*\*Y\*\*인 공통코드 목록을 조회합니다.\
> \* 참조코드(referCode), 코드(code)는 필수입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CodeReqDto":{"type":"object","description":"공통코드 조회 요청 DTO","properties":{"code":{"type":"string","description":"그룹코드"},"referCode":{"type":"string","description":"참조코드"},"type":{"type":"string","description":"조회타입"},"grpCds":{"type":"string","description":"그룹코드"},"langCd":{"type":"string","description":"언어코드"}}},"ResponseMapStringListCodeResDto":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CodeResDto"}},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CodeResDto":{"type":"object","description":"공통코드 조회 응답 DTO","properties":{"key":{"type":"string","description":"map의 키"},"cd":{"type":"string","description":"그룹코드"},"cdNm":{"type":"string","description":"코드명"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/common/code/getCdCdNmFromStStdCdByGrpCdOrderRef3Val":{"get":{"tags":["공통코드 조회"],"summary":"참조3값 기준 공통코드 조회","description":"## 기능설명\n* 참조3값 기준으로 공통코드 목록을 조회합니다.\n---\n## 상세설명\n* 코드가 가진 참조3값을 기준으로 공통코드 목록을 조회합니다.\n* 사용여부가 **Y**인 공통코드 목록을 조회합니다.\n* 참조코드(referCode), 코드(code)는 필수입니다.\n","operationId":"getCdCdNmFromStStdCdByGrpCdOrderRef3Val","parameters":[{"name":"params","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CodeReqDto"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringListCodeResDto"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-26.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.