API-first
Każda funkcja dostępna przez kompletne REST API. Automatyzuj wszystko.
Pełne REST API
Każda funkcja dostępna w panelu administracyjnym jest dostępna programowo. Bez wyjątków.
Oficjalne SDK
Type-safe biblioteki klienckie dla TypeScript, Python, Go i kolejnych języków. Start w kilka minut.
Webhooki
Powiadomienia o zdarzeniach w czasie rzeczywistym dla cyklu życia użytkownika, zdarzeń logowania i zmian konfiguracji.
0
Każda funkcja jest dostępna przez API
Specyfikacja OpenAPI 3.1
Kompletna specyfikacja czytelna dla maszyn
Webhooki czasu rzeczywistego
Dostarczanie zdarzeń poniżej sekundy
noo id jest budowane API-first: REST API to główny interfejs, a panel administracyjny to tylko jeden z klientów. Oficjalne SDK dla wielu języków zapewniają w pełni typowany dostęp do wszystkich endpointów, a webhooki w czasie rzeczywistym utrzymują Twoje systemy w synchronizacji bez cyklicznego odpytywania.
Kompletne REST API
Każda funkcja panelu administracyjnego jest dostępna programowo przez dobrze zaprojektowane REST API. Użyj oficjalnego SDK TypeScript do zarządzania użytkownikami, sesjami, grupami i politykami uwierzytelniania z pełnym bezpieczeństwem typów.
import { NooClient } from '@noo-id/sdk';
const client = new NooClient({
apiKey: process.env.NOO_API_KEY,
});
const user = await client.users.create({
email: 'alice@acme.com',
name: 'Alice Smith',
});
Oficjalne SDK
TypeScript
W pełni typowany klient z natywnymi definicjami TypeScript. Instalacja: npm install @noo-id/sdk.
Python
SDK z adnotacjami typów kompatybilnymi z mypy do analizy statycznej. Instalacja: pip install noo-id.
Go
Silnie typowane struktury i idiomatyczna obsługa błędów. Instalacja: go get github.com/noo-id/noo-go.
Ruby
Idiomatyczny klient Ruby z wbudowaną logiką ponowień. Instalacja: gem install noo_id.
PHP
SDK zgodne z PSR i pełnym pokryciem typów. Instalacja: composer require noo-id/sdk.
Java
Klient oparty o generyki ze wsparciem async. Dostępny w Maven jako com.noo.id:noo-sdk.
Przepływ zdarzeń webhook
Otrzymuj powiadomienia HTTP w czasie rzeczywistym o zdarzeniach w noo id. Subskrybuj cykl życia użytkownika, zdarzenia logowania i zmiany konfiguracji z automatycznym ponawianiem i gwarancją dostarczenia.
Występuje zdarzenie
Użytkownik rejestruje się, loguje, aktualizuje profil albo wykonuje inną śledzoną akcję.
noo id wysyła POST
Żądanie HTTP POST z podpisanym ładunkiem JSON trafia na skonfigurowany endpoint webhook.
Aplikacja weryfikuje podpis
Zweryfikuj nagłówek X-Noo-Signature przez HMAC SHA-256, aby potwierdzić autentyczność żądania.
Przetwarzaj asynchronicznie
Odpowiedz od razu kodem 200, a ładunek przetwarzaj w tle przez kolejkę.
Doświadczenie deweloperskie
Specyfikacja OpenAPI 3.1
Kompletna specyfikacja czytelna dla maszyn do generowania klientów, importu do Postmana i walidacji żądań.
Dokumentacja interaktywna
Testuj wywołania API bezpośrednio w przeglądarce na gotowych przykładach zapytań i odpowiedzi.
Strukturalne błędy
Każdy błąd zwraca spójne JSON z kodem błędu, czytelnym komunikatem i linkiem do dokumentacji.
Rate limiting
Przejrzyste limity i nagłówki X-RateLimit w każdej odpowiedzi, aby proaktywnie sterować ruchem.
Frequently asked questions
Co dokładnie oznacza API-first? +
API-first oznacza, że API nie jest dodatkiem, tylko głównym interfejsem noo id. Każda funkcja powstaje najpierw jako API, a panel administracyjny jest tylko kolejnym klientem tego API. Dzięki temu masz pełny dostęp programowy do całej funkcjonalności, pełną automatyzację i łatwe integracje własne.
Które języki mają oficjalne SDK? +
noo id udostępnia oficjalne SDK dla TypeScript/JavaScript, Python, Go, Ruby, PHP, Java i .NET. Wszystkie SDK są open source, generowane automatycznie ze specyfikacji OpenAPI i zapewniają pełne typowanie TypeScript albo porównywalne bezpieczeństwo typów w innych językach.
Jak działają webhooki i na jakie zdarzenia mogę się zapisać? +
Webhooki wysyłają żądania HTTP POST do Twojego endpointu natychmiast po zajściu zdarzeń. Możesz subskrybować zdarzenia użytkowników (utworzenie, aktualizacja, usunięcie), zdarzenia logowania (logowanie, wylogowanie, MFA), akcje administratorów i inne. Webhooki obejmują logikę ponowień, weryfikację podpisu i gwarancje dostarczenia.