---
title: API Supernova
description: Automatyzuj Supernova przez niewersjonowane API HTTPS, używając danych bearer o ograniczonych zakresach i ustrukturyzowanych błędów.
species: reference
---
# API Supernova

Używaj `https://api.supernova.ai`, aby odpytywać dane, przeglądać katalog, zarządzać źródłami, śledzić uruchomienia, wywoływać wysyłki, odczytywać dzienniki i użycie oraz zarządzać osobistymi tokenami dostępu.

```bash
curl https://api.supernova.ai/whoami \
  -H "Authorization: Bearer pat_..."
```

## Kontrakt

Ścieżki API nie zawierają segmentu wersji. Odpowiedzi zawierają `Supernova-Version` do obserwacji i `Request-Id` na potrzeby pomocy technicznej. Mogą pojawiać się dodatkowe pola odpowiedzi; klient powinien ignorować pola, których nie rozumie.

Obiekty zasobów mają wyróżnik `object` i identyfikatory z prefiksami. Kolekcje używają `{"object":"list","data":[...]}` i w przypadku stronicowania zasobu udostępniają `has_more` razem z kursorem.

## Zasoby

| Zasób | Przeznaczenie |
|---|---|
| [Zapytania](/docs/api/queries) | Przesyłanie SQL i pobieranie wyników Parquet lub w odpowiedzi |
| [Zadania](/docs/api/jobs) | Wyświetlanie, przeglądanie, śledzenie i anulowanie uruchomień oraz pobieranie wyników |
| [Katalog](/docs/api/catalog) | Wyświetlanie schematów i kolumn tabel |
| [Źródła](/docs/api/sources) | Wyświetlanie, tworzenie, zmiana, testowanie i usuwanie źródeł |
| [Synchronizacje](/docs/api/sync) | Uruchamianie synchronizacji źródła i śledzenie postępu |
| [Wysyłki](/docs/api/sends) | Przeglądanie i sterowanie skonfigurowanymi wysyłkami |
| [Dzienniki](/docs/api/logs) | Odczytywanie błędów źródeł i zmian schematu |
| [Użycie](/docs/api/usage) | Odczytywanie miesięcznego użycia i prognozowanego kosztu |
| [PAT](/docs/api/pats) | Tworzenie, wyświetlanie i unieważnianie osobistych tokenów dostępu |

## Limity szybkości

Każdy wywołujący może wysłać 120 żądań na minutę. Każda organizacja może wysłać łącznie 600 żądań na minutę dla wszystkich wywołujących. Odpowiedź `429 rate_limited` zawiera `Retry-After` w sekundach. Odpytywanie i ponowne łączenie strumieni liczy się jako żądania.

## Idempotencja

Endpointy mutacji, które informują o idempotencji, przyjmują `Idempotency-Key`. Powtórzenie dla tego samego podmiotu i organizacji zwraca pierwotny zasób. Ponowne użycie klucza z innymi danymi zwraca `409`, zamiast zgadywać zamierzoną operację.