Appearance
배지 템플릿 목록 조회
GET
/badge-templates
배지 템플릿 목록을 조회합니다. 템플릿 ID, 제목, 사용 여부, 카테고리, 배지 유형, 등록일 범위로 필터링합니다.
Authorizations
ApiKeyAuth
Type
API Key (header: X-API-Key)
요청 파라미터
| 필드명 | 위치 | 타입 | 필수 여부 | 기본값 | 설명 |
|---|---|---|---|---|---|
page | query | integer | Optional | 1 | 조회할 페이지 번호 (미전달 시 1) |
rows_per_page | query | integer | Optional | 20 | 페이지당 항목 수 (미전달 시 20, 최대 100) |
sort_by | query | array<string> | Optional | - | 정렬 컬럼명. 여러 개 지정 시 파라미터를 반복합니다 (예: `sort_by=reg_date&sort_by=title`). |
sort_type | query | array<string> | Optional | - | 정렬 방향. `sort_by`와 같은 순서로 반복합니다 (예: `sort_type=desc`). |
template_id | query | string | Optional | - | 템플릿 ID 필터 |
title | query | string | Optional | - | 배지 제목 부분 일치 검색 |
use_yn | query | string | Optional | - | 사용 여부 필터 (Y, N) |
category_id | query | string | Optional | - | 카테고리 ID 필터 |
badge_type | query | string | Optional | - | 배지 유형 필터 (COMPLETE, COMPETENCY, ACHIEVE, PARTICIPATE, CERTIFICATE) |
category_level_id | query | string | Optional | - | 카테고리 레벨 ID 필터 |
reg_str_date | query | string · date | Optional | - | 등록 시작일 (예: 2026-01-01) |
reg_end_date | query | string · date | Optional | - | 등록 종료일 (예: 2026-12-31) |
Responses
배지 템플릿 목록
application/json
JSON "code": "0001", "message": "요청 성공하였습니다.", "data": { "list": [ { "template_id": "TPL00000000005", "title": "Certified Software Architect", "badge_type_name": "참여", "category_name": "내부훈련", "level": 1, "level_name": "입문", "image_url": "/api/cmmn/link/objgrp003/object003.png", "use_yn": "Y", "reg_date": "2026-01-13 10:32:30" } ], "total_count": 3, "page": 1, "rows_per_page": 20 }
{
}
GET
/badge-templates