Core API
GenD 플랫폼의 핵심 데이터 처리 API 그룹입니다. SQL 쿼리 실행, 카탈로그 탐색, 커넥터 관리, 쿼리 저장, 헬스 체크 기능을 제공합니다.
API 목록
| API | 경로 | 설명 |
|---|---|---|
| Query | /api/v1/query | SQL 쿼리 실행 및 결과 조회 |
| Catalog | /api/v1/catalog | 카탈로그/스키마/테이블 메타데이터 탐색 |
| Connector | /api/v1/connectors | 데이터 소스 커넥터 CRUD |
| Saved Query | /api/v1/queries/saved | 저장 쿼리 관리 |
| Health | /health | 서비스 상태 확인 |
공통 사항
- Query, Catalog, Connector, Saved Query API는 JWT Bearer 토큰 인증이 필요합니다.
- Health API는 인증 없이 접근 가능한 퍼블릭 엔드포인트입니다.
- Metrics(
GET /metrics)는 Prometheus 형식으로 메트릭을 노출하며, 인증이 필요하지 않습니다. - 모든 요청은 AuditMiddleware를 통해 감사 로그로 기록됩니다.
에러 형식
모든 Core API는 공통 에러 응답 형식을 따릅니다:
{
"detail": "에러 메시지"
}