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.
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 | Przesyłanie SQL i pobieranie wyników Parquet lub w odpowiedzi |
| Zadania | Wyświetlanie, przeglądanie, śledzenie i anulowanie uruchomień oraz pobieranie wyników |
| Katalog | Wyświetlanie schematów i kolumn tabel |
| Źródła | Wyświetlanie, tworzenie, zmiana, testowanie i usuwanie źródeł |
| Synchronizacje | Uruchamianie synchronizacji źródła i śledzenie postępu |
| Wysyłki | Przeglądanie i sterowanie skonfigurowanymi wysyłkami |
| Dzienniki | Odczytywanie błędów źródeł i zmian schematu |
| Użycie | Odczytywanie miesięcznego użycia i prognozowanego kosztu |
| PAT | 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ę.