---
title: Supernova API
description: 범위가 지정된 bearer 자격 증명과 구조화된 오류를 사용하는 버전 경로 없는 HTTPS API로 Supernova를 자동화합니다.
species: reference
---
# 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`를 제공합니다.

## 리소스

| 리소스 | 용도 |
|---|---|
| [쿼리](/docs/api/queries) | SQL을 제출하고 Parquet 또는 인라인 결과 가져오기 |
| [작업](/docs/api/jobs) | 실행 목록 조회, 확인, 추적, 취소 및 결과 가져오기 |
| [카탈로그](/docs/api/catalog) | 스키마 목록 조회 및 테이블 열 확인 |
| [소스](/docs/api/sources) | 소스 목록 조회, 생성, 변경, 테스트, 삭제 |
| [동기화](/docs/api/sync) | 소스 동기화 시작 및 진행 상황 추적 |
| [전송](/docs/api/sends) | 설정된 전송 확인 및 제어 |
| [로그](/docs/api/logs) | 소스 오류 및 스키마 변경 읽기 |
| [사용량](/docs/api/usage) | 월별 측정 사용량 및 예상 비용 조회 |
| [PAT](/docs/api/pats) | 개인 액세스 토큰 생성, 목록 조회, 폐기 |

## 요청 빈도 제한

호출자마다 분당 120회 요청할 수 있습니다. 조직마다 모든 호출자를 합쳐 분당 600회 요청할 수 있습니다. `429 rate_limited` 응답에는 초 단위의 `Retry-After`가 포함됩니다. 폴링과 스트림 재연결도 요청으로 계산됩니다.

## 멱등성

멱등성을 지원한다고 명시한 변경 엔드포인트는 `Idempotency-Key`를 받습니다. 동일한 주체와 조직으로 다시 요청하면 원래 리소스를 반환합니다. 다른 입력에 같은 키를 재사용하면 의도한 작업을 추측하지 않고 `409`를 반환합니다.