카테고리 목록 조회

GET

/categories

배지 카테고리 목록을 레벨 정보와 함께 조회합니다. 사용 여부, 카테고리명, 레벨 사용 여부로 필터링합니다. 이 엔드포인트는 페이징을 지원하지 않으며 전체 목록을 반환합니다.

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

요청 파라미터

필드명	위치	타입	필수 여부	기본값	설명
use_yn	query	string	Optional	-	사용 여부 필터 (Y, N)
category_name	query	string	Optional	-	카테고리명 부분 일치 검색
level_yn	query	string	Optional	-	레벨 사용 여부 필터 (Y, N)

Responses

카테고리 목록

Content-Type

application/json

{

  

"code": "0001",

  

"message": "요청 성공하였습니다.",

  

"data": [

  

  

{

  

  

  

"category_id": "CAT00000000003",

  

  

  

"category_cd": "CCN1IXAX",

  

  

  

"category_name": "글로벌 역량",

  

  

  

"description": "글로벌 역량 카테고리",

  

  

  

"level_yn": "N",

  

  

  

"use_yn": "Y",

  

  

  

"reg_date": "2026-01-22 09:38:20",

  

  

  

"upd_date": null,

  

  

  

"levels": [

  

  

  

]

  

  

},

  

  

{

  

  

  

"category_id": "CAT00000000004",

  

  

  

"category_cd": "CCULA7K2",

  

  

  

"category_name": "내부훈련",

  

  

  

"description": "내부훈련 카테고리",

  

  

  

"level_yn": "Y",

  

  

  

"use_yn": "Y",

  

  

  

"reg_date": "2026-01-07 18:40:11",

  

  

  

"upd_date": null,

  

  

  

"levels": [

  

  

  

  

{

  

  

  

  

  

"level": 1,

  

  

  

  

  

"level_name": "입문"

  

  

  

  

},

  

  

  

  

{

  

  

  

  

  

"level": 2,

  

  

  

  

  

"level_name": "중급"

  

  

  

  

},

  

  

  

  

{

  

  

  

  

  

"level": 3,

  

  

  

  

  

"level_name": "심화"

  

  

  

  

}

  

  

  

]

  

  

}

  

]

}

GET

/categories

Samples