Feature

Feature Store의 피처 정의를 관리하는 API입니다. 피처 생성, 조회, 삭제 및 미리보기 기능을 제공합니다.

엔드포인트

POST /api/v1/features

설명: 새 피처를 정의합니다. (HTTP 201)

요청 본문:

필드	타입	필수	설명
name	string	Y	피처 이름 (영문, 밑줄만 허용)
sql	string	Y	피처 정의 SQL
tags	array	N	태그 목록
description	string	N	피처 설명

GET /api/v1/features

설명: 피처 목록을 반환합니다. 태그 기반 필터를 지원합니다.

쿼리 파라미터:

파라미터	타입	필수	설명
tags	string	N	콤마 구분 태그 필터

GET /api/v1/features/{feature_name}

설명: 특정 피처의 상세 정보를 반환합니다.

DELETE /api/v1/features/{feature_name}

설명: 피처를 삭제합니다. (HTTP 204)

GET /api/v1/features/{feature_name}/preview

설명: 피처 SQL의 실행 미리보기 결과를 반환합니다.

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드	설명
400	잘못된 피처 이름 또는 SQL
404	피처를 찾을 수 없음
500	피처 SQL 실행 실패