API

API klasy enterprise — integracja w godzinach, nie tygodniach

REST i GraphQL API z pełną dokumentacją, SDK dla 6 języków i SLA 99,9% — gotowe na obciążenia produkcyjne od pierwszego dnia.

Przejrzyj dokumentację
Wizualizacja sieci węzłów API i strumieni danych

Co kryje się pod maską naszego API

API Nowy Grupa to warstwa integracyjna zbudowana na GraphQL i REST, obsługująca ponad 200 milionów zapytań miesięcznie dla klientów produkcyjnych. Udostępniamy oficjalne SDK dla JavaScript/TypeScript, Python, Go, Java, Ruby i PHP — każde z pełnym pokryciem testami i automatycznie generowaną dokumentacją zgodną z OpenAPI 3.1. Infrastruktura API opiera się na edge nodes rozmieszczonych w trzech regionach europejskich, co zapewnia medianę latency poniżej 45 ms dla ruchu z terytorium Polski i Europy Środkowej. Webhooks, rate limiting, OAuth 2.0 i klucze API z granularnym zakresem uprawnień są dostępne na wszystkich planach.

Czego potrzebuje każdy zespół deweloperski przy integracji API

Projektujemy nasze API tak, by programiści mogli skupić się na logice biznesowej — nie na walce z infrastrukturą i dokumentacją.

Dokumentacja, która działa

Interaktywny playground oparty na Swagger UI pozwala testować każdy endpoint bez jednej linii kodu. Dokumentacja jest generowana automatycznie z kodu źródłowego i aktualizowana przy każdym release — zawsze aktualna, zawsze zsynchronizowana z produkcją.

Bezpieczeństwo bez kompromisów

OAuth 2.0, JWT tokeny z konfigurowalnymi czasami wygasania, IP whitelisting i audit log każdego żądania API. Dla klientów Enterprise dostępna jest opcja dedykowanego VPC peering, która eliminuje ruch przez publiczny internet.

Obserwability wbudowana w API

Każde żądanie API zwraca nagłówki z trace ID, co ułatwia debugowanie w systemach rozproszonych. Nativa integracja z OpenTelemetry pozwala na przesyłanie metryk do Datadog, Grafana Cloud lub własnej instancji Prometheus bez dodatkowej konfiguracji.

Wersjonowanie bez bólu

Nowy Grupa gwarantuje minimum 18 miesięcy wsparcia dla każdej wersji API po ogłoszeniu deprecacji. Migracje między wersjami są wspierane przez narzędzie migration tool dostępne w CLI — automatycznie wykrywa breaking changes i proponuje kod zastępczy.

Najczęstsze pytania o API Nowy Grupa

Ile wynosi limit zapytań na planie Starter?

Plan Starter obejmuje 500 000 zapytań API miesięcznie z rate limiting na poziomie 100 req/s. Po przekroczeniu limitu zapytania są kolejkowane, nie odrzucane — nie traci Pan/Pani danych. Limit można zwiększyć w dowolnym momencie bez zmiany planu.

Czy API jest dostępne w ramach SLA 99,9%?

Tak. Gwarancja SLA 99,9% obejmuje endpoint availability i jest potwierdzona umową z penaltami finansowymi na planach Pro i Enterprise. Status w czasie rzeczywistym jest dostępny publicznie pod adresem status.sparkoforge.today.

Jak wygląda obsługa błędów i retry logic?

API zwraca standardowe kody HTTP ze szczegółowymi komunikatami błędów zgodnie ze specyfikacją RFC 7807 (Problem Details). Nasze SDK implementują exponential backoff z jitter dla odpowiedzi 429 i 503 — w większości przypadków nie trzeba pisać własnej logiki retry.

Czy mogę przetestować API przed zakupem?

Tak. Dostępne jest darmowe konto Sandbox z limitem 10 000 zapytań miesięcznie, pełnym dostępem do dokumentacji i interaktywnym playground. Rejestracja nie wymaga podania karty kredytowej — wystarczy adres e-mail.

Zacznij integrację już dziś

Zarejestruj konto Sandbox i przetestuj API Nowy Grupa bez karty kredytowej — pierwsze 10 000 zapytań gratis.

Utwórz konto Sandbox