Supernova API#
https://api.supernova.ai에서 데이터를 쿼리하고, 카탈로그를 살펴보고, 소스를 관리하고, 실행을 추적하고, 전송을 시작하고, 로그와 사용량을 읽고, 개인 액세스 토큰을 관리하세요.
bash
curl https://api.supernova.ai/whoami \
-H "Authorization: Bearer pat_..."계약#
API 경로에는 버전 구간이 없습니다. 응답에는 관측을 위한 Supernova-Version과 지원 요청에 사용할 Request-Id가 포함됩니다. 응답 필드가 추가될 수 있으므로 클라이언트는 알지 못하는 필드를 무시해야 합니다.
리소스 객체에는 object 구분자와 접두사가 붙은 ID가 있습니다. 컬렉션은 {"object":"list","data":[...]} 형식을 사용하며, 페이지로 나뉜 리소스는 커서와 함께 has_more를 제공합니다.
리소스#
| 리소스 | 용도 |
|---|---|
| 쿼리 | SQL을 제출하고 Parquet 또는 인라인 결과 가져오기 |
| 작업 | 실행 목록 조회, 확인, 추적, 취소 및 결과 가져오기 |
| 카탈로그 | 스키마 목록 조회 및 테이블 열 확인 |
| 소스 | 소스 목록 조회, 생성, 변경, 테스트, 삭제 |
| 동기화 | 소스 동기화 시작 및 진행 상황 추적 |
| 전송 | 설정된 전송 확인 및 제어 |
| 로그 | 소스 오류 및 스키마 변경 읽기 |
| 사용량 | 월별 측정 사용량 및 예상 비용 조회 |
| PAT | 개인 액세스 토큰 생성, 목록 조회, 폐기 |
요청 빈도 제한#
호출자마다 분당 120회 요청할 수 있습니다. 조직마다 모든 호출자를 합쳐 분당 600회 요청할 수 있습니다. 429 rate_limited 응답에는 초 단위의 Retry-After가 포함됩니다. 폴링과 스트림 재연결도 요청으로 계산됩니다.
멱등성#
멱등성을 지원한다고 명시한 변경 엔드포인트는 Idempotency-Key를 받습니다. 동일한 주체와 조직으로 다시 요청하면 원래 리소스를 반환합니다. 다른 입력에 같은 키를 재사용하면 의도한 작업을 추측하지 않고 409를 반환합니다.