Saved Query

자주 사용하는 SQL 쿼리를 저장하고 관리하는 API입니다. 쿼리를 이름, 설명과 함께 저장하고 재사용할 수 있습니다.

엔드포인트

POST /api/v1/queries/saved

설명: 새 쿼리를 저장합니다. (HTTP 201)

요청 본문:

필드	타입	필수	설명
name	string	Y	쿼리 이름
sql	string	Y	SQL 문
description	string	N	쿼리 설명

GET /api/v1/queries/saved

설명: 저장된 쿼리 목록을 반환합니다. 페이지네이션을 지원합니다.

GET /api/v1/queries/saved/{query_id}

설명: 특정 저장 쿼리의 상세 정보를 반환합니다.

PUT /api/v1/queries/saved/{query_id}

설명: 저장된 쿼리를 수정합니다.

DELETE /api/v1/queries/saved/{query_id}

설명: 저장된 쿼리를 삭제합니다. (HTTP 204)

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드	설명
400	잘못된 요청 (필수 필드 누락)
404	쿼리를 찾을 수 없음
500	서버 내부 오류