01AI i integracje · moduł
Automatyczne REST API i webhooki
Sterowane metadanymi REST API dla każdej encji wraz z dokumentacją OpenAPI i webhookami
- Webhook
- Klucz API
- Osobisty token dostępu
- Dziennik dostępu
- 10
- funkcjonalności
- 4
- typy rekordów
- 3
- automatyzacje
- 4
- integracje i narzędzia AI
02Co potrafi moduł
Mniej rutyny. Więcej wartości.
Draivix automatycznie generuje REST API dla każdej encji na podstawie metadanych, bez konieczności kodowania poszczególnych endpointów. Gdy tylko dodasz pole, relację lub encję, zarówno API, jak i dokumentacja OpenAPI są natychmiast dostępne — zawsze w zakresie uprawnień wywołującego. Twoja firma może połączyć sklep internetowy, raportowanie lub własną aplikację z dokładnie tymi samymi danymi i regułami, które obowiązują w systemie.
- Automatycznie generowane APIREST API — interfejs do łączenia systemów zewnętrznych — powstaje dla każdej encji bez pisania kodu, również dla encji i pól dodanych przez administratora. Każde nowe pole jest dostępne od ręki.
- Kontrolowane operacje na rekordachAPI obsługuje listy, widoki szczegółowe, tworzenie, aktualizacje oraz miękkie usuwanie, w którym rekord jest jedynie oznaczany jako usunięty. Uprawnienia są egzekwowane zarówno na poziomie rekordu, jak i poszczególnych pól.
- Ochrona przed nadpisaniem równoczesnych zmianBlokowanie optymistyczne oparte na wersji rekordu zapobiega nadpisaniu jednej aktualizacji przez drugą. Gdy dwa systemy modyfikują ten sam rekord jednocześnie, nigdy nie nadpiszą nawzajem swoich danych.
- Zmiany masowe w jednej transakcjiMasowo utwórz do 100 rekordów, zaktualizuj do 500 i usuń do 100. Łączone zmiany wykonują się w jednej transakcji, dzięki czemu częściowe aktualizacje nigdy nie zostają zapisane.
- Filtrowanie bez wycieku danychFiltruj zapytania za pomocą pięciu notacji, z wyszukiwaniem pełnotekstowym i gotowymi zakresami dat. API odrzuca nieznane pola, pola bez prawa odczytu oraz niedozwolone operatory, więc filtry nigdy nie ujawniają nieautoryzowanych danych.
- Dokumentacja dopasowana do uprawnieńSpecyfikacja OpenAPI 3.1.2 jest generowana na podstawie uprawnień wywołującego. Programiści widzą wyłącznie te encje i operacje, z których mogą korzystać.
- Uwierzytelnianie stworzone także dla agentówUzyskaj token, logując się z uwierzytelnianiem dwuskładnikowym lub podpisując żądanie kluczem SSH. Druga opcja idealnie sprawdza się w przypadku agentów wiersza poleceń.
- Limity zapytań i pełne logowanie wywołańLimit zapytań wynosi 240 żądań na minutę na firmę i użytkownika, a dziennik dostępu rejestruje każde wywołanie. Zachowujesz pełny wgląd w cały ruch API.
- Wysyłaj dane tam, gdzie potrzebujeszPrzepływ pracy wysyła webhook — automatyczny komunikat do systemu zewnętrznego — z wykorzystaniem własnego szablonu treści. Docelowe adresy URL przechodzą przez ochronę SSRF, aby serwer nie mógł zostać wykorzystany do wysyłania żądań pod nieautoryzowane adresy.
- Zweryfikowane dane przychodzącePrzychodzący webhook odbiera dane pod dedykowanym endpointem chronionym współdzielonym sekretem w nagłówku. Każde wywołanie jest logowane wraz z wynikiem, dzięki czemu zawsze widzisz, co dotarło do systemu.
03Jak to działa
Jak to działa krok po kroku.
Jak działa automatyczne API
API nie wymaga osobnego kodu dla każdej encji. Jeden zestaw uniwersalnych ścieżek obsługuje każdą encję znaną systemowi. Gdy administrator doda encję, pole lub relację — albo gdy wdrożony zostanie nowy moduł — API, walidacja i dokumentacja są dostępne od razu, w ramach danej firmy oraz uprawnień wywołującego.
Zobacz szczegóły
O dostępności encji decydują trzy warunki: flaga API na encji, moduł włączony dla danej firmy oraz uprawnienia wywołującego, w tym polityka klucza API. Ukryta encja zwraca odpowiedź „nie znaleziono” i nawet nie ujawnia swojego istnienia. Sejf haseł oraz preferencje użytkownika nie są dostępne przez API. Zarówno zalogowana sesja w przeglądarce, jak i token w nagłówku działają według tych samych reguł oraz rejestrowania w dzienniku audytu co aplikacja.
Możliwości API
Każda encja obsługuje pobieranie list, szczegółów rekordu, tworzenie, pełną lub częściową aktualizację oraz miękkie usuwanie (soft delete). Częściowe aktualizacje wspierają blokowanie optymistyczne na podstawie wersji rekordu, co zapobiega wzajemnemu nadpisaniu dwóch równoczesnych zmian. Możesz także odpytać opis encji (pola, relacje, akcje), pobrać listę identyfikatorów dla przefiltrowanego zbioru (do 500) oraz wyeksportować rekordy (do 1 000).
Zobacz szczegóły
W operacjach masowych można utworzyć do 100 rekordów, zaktualizować do 500 i usunąć do 100; łączona paczka operacji tworzenia, aktualizacji i usuwania wykonuje się w jednej transakcji. Agregacje zwracają sumy, średnie oraz inne wskaźniki lub liczby rekordów pogrupowane według wybranego pola. API obsługuje również relacje (dołączanie, odłączanie, synchronizację), panele powiązanych rekordów, historię zmian, dzienniki audytu, załączniki, akcje dla pojedynczego rekordu i zaznaczenia, konwersje rekordów z podglądem, słowniki wartości oraz wyszukiwanie globalne.
Zarządzane statusy można zmieniać wyłącznie za pomocą akcji.
Zapytania i filtry
Filtry można zapisywać na kilka sposobów: w notacji nawiasowej, jako grupy OR, zagnieżdżone drzewo, skrócone wyrażenia typu amount>=10000, obiekt JSON lub zapisany filtr. Obsługiwane są wyszukiwanie pełnotekstowe, sortowanie, stronicowanie (domyślnie 20, maksymalnie do 200 rekordów na stronę), wybór pól oraz zachłanne ładowanie (eager loading) powiązanych rekordów.
Zobacz szczegóły
Operatory obejmują porównania, zawieranie tekstu, dopasowanie początku, zakresy, puste wartości, wybór wielu wartości, gotowe zakresy dat (np. bieżący miesiąc lub ostatnie 30 dni) oraz powiązania z bieżącym użytkownikiem lub jego zespołem. API odrzuca nieznane pola, pola bez uprawnień do odczytu oraz niedozwolone operatory, dzięki czemu filtrów nie da się wykorzystać do sondowania danych, których wywołujący nie ma prawa widzieć.
Dokumentacja, uwierzytelnianie i limity zapytań
Specyfikacja OpenAPI 3.1.2 jest generowana w locie z metadanych i z perspektywy wywołującego: encje oraz operacje, do których wywołujący nie ma uprawnień, są pomijane. Administratorzy mogą przeglądać ją w panelu administracyjnym za pomocą przeglądarki Scalar. Walidacja i dokumentacja korzystają z tych samych definicji, dlatego na objętych nimi ścieżkach nigdy się nie rozjeżdżają.
Zobacz szczegóły
Token uzyskasz, logując się (z kodem drugiego składnika, jeśli jest włączony) lub podpisując żądanie kluczem SSH w przypadku agentów wiersza poleceń. Użytkownicy zarządzają kluczami API oraz tokenami MCP w swoim profilu. Limit zapytań wynosi 240 żądań na minutę na firmę i użytkownika; po 10 nieudanych próbach użycia tokenu w ciągu minuty adres IP jest ograniczany. Każde wywołanie uwierzytelnione tokenem jest zapisywane w dzienniku dostępu.
Webhooki
Wychodzący webhook to akcja w przepływie pracy modułu Automatyzacja. Uruchamia się po zmianie lub usunięciu rekordu, według harmonogramu, ręcznie albo w reakcji na zdarzenie domenowe. Wysyła żądanie POST, PUT lub PATCH z własnymi nagłówkami i szablonem treści. Docelowy adres URL jest weryfikowany przez ochronę przed SSRF, przekierowania są wyłączone, a limit czasu (timeout) wynosi 30 sekund. Żądania nie są podpisywane; nieudane wywołania są logowane i ponawiane wyłącznie w przypadku atomowych przepływów pracy lub akcji skonfigurowanych tak, aby zatrzymywały się przy błędzie.
Zobacz szczegóły
Przychodzący webhook odbiera dane pod dedykowanym endpointem chronionym współdzielonym sekretem w nagłówku. Dane przetwarza procedura obsługi zarejestrowana przez moduł — np. przechwytywanie leadów CRM, nagrań rozmów lub zdarzeń push z komunikatora Mattermost. Każde wywołanie jest rejestrowane wraz z wynikiem.
04Co dzieje się automatycznie
Automatyzacje, które oszczędzają czas.
Dokumentacja zawsze zgodna z API
Dokumentacja OpenAPI jest generowana w locie z metadanych oraz uprawnień wywołującego. Walidacja i dokumentacja korzystają z tych samych definicji, dzięki czemu obsługiwane endpointy nigdy się nie rozjeżdżają.
Automatyczne rejestrowanie dostępu
Każde wywołanie uwierzytelnione tokenem jest automatycznie zapisywane w dzienniku dostępu. Podczas diagnozowania integracji masz do dyspozycji wiarygodną ścieżkę audytu.
Webhooki wyzwalane we właściwym momencie
Przepływ pracy w module Automatyzacja wysyła webhook po zdarzeniach takich jak aktualizacja lub usunięcie rekordu, według harmonogramu albo ręcznie — informując systemy zewnętrzne w czasie rzeczywistym.
Integracje zewnętrzne
- Podłącz własne systemyDowolny system zewnętrzny może połączyć się przez REST API po szyfrowanym protokole HTTPS z użyciem tokenu. Twój sklep internetowy, narzędzia raportowe lub dedykowane aplikacje pracują na dokładnie tych samych danych i regułach co główna aplikacja.
- Odbieraj dane z systemów zewnętrznychSystemy zewnętrzne wysyłają dane na przychodzący webhook, gdzie przetwarza je procedura obsługi zarejestrowana przez moduł — np. przychodzące leady CRM, nagrania rozmów lub powiadomienia push z Mattermost.
- Przepływy pracy wywołują systemy docelowePrzepływ pracy wysyła żądanie POST, PUT lub PATCH do systemu docelowego z własnymi nagłówkami i szablonem treści, powiadamiając system zewnętrzny o każdej istotnej zmianie.
Czym zajmuje się agent AI
Te same reguły dla AI
Zarówno wbudowany asystent AI, jak i agenci połączeni przez MCP (Model Context Protocol) korzystają z tych samych uniwersalnych operacji na encjach co REST API, egzekwując dokładnie te same kontrole uprawnień.
Człowiek zatwierdza zawsze, gdy w grę wchodzą pieniądze, klient lub wyjątek.
05Często zadawane pytania
Czy Draivix posiada REST API?
Tak. API jest generowane automatycznie dla każdej encji z metadanych — w tym dla własnych pól i encji dodanych przez administratora — i zawsze respektuje uprawnienia wywołującego.
Gdzie znajdę dokumentację API?
Endpoint /api/openapi.json zwraca specyfikację OpenAPI 3.1.2, którą administratorzy mogą też przeglądać w panelu administracyjnym. Zawiera ona wyłącznie te encje i operacje, do których wywołujący ma uprawnienia.
Czy Draivix obsługuje webhooki?
Tak. Wychodzące webhooki są wysyłane przez przepływy pracy w module Automatyzacja, natomiast przychodzące webhooki są odbierane pod dedykowanym endpointem chronionym współdzielonym sekretem.
Jakie są limity zapytań API?
Limit wynosi 240 żądań na minutę na firmę i użytkownika, pojedyncza strona listy zwraca do 200 rekordów, a eksport zwraca do 1 000 rekordów.
06Powiązane moduły
Moduły, które świetnie ze sobą współpracują.
Wszystkie moduły w obszarze AI i integracje- Automatyzacja i przepływy pracyReguły no-code typu „gdy nastąpi X, wykonaj Y” oraz harmonogram rekordów cyklicznych
- MCP dla zewnętrznych agentów AIPodłącz Claude Code, Codex i inne agenty do swojego ERP w ramach uprawnień konkretnego użytkownika
- Asystent AI w DraivixAsystent wbudowany w aplikację, który wyszukuje dane, przygotowuje projekty zmian i zapisuje je dopiero po Twoim zatwierdzeniu
- OAuth2 i OIDC dla dodatkówBezpieczne logowanie dodatków do Draivix przez OAuth2 i OpenID Connect z PKCE
- CRM i lejek sprzedażyProspekty, leady i szanse sprzedaży z kontrolowanymi etapami, prognozowaniem i przepływami pieniężnymi (cashflow)
- Asystent głosowy i transkrypcja mowy na tekstDyktuj zapytania, transkrybuj nagrania i obsługuj system ERP głosem dzięki asystentowi AI
- Import sklepu internetowego z WooCommerceWczytuje katalog, klientów i zamówienia z WooCommerce oraz wysyła opisy produktów z powrotem do sklepu internetowego
- Migracja z EspoCRM i praca równoległaPorównuje i synchronizuje rekordy z EspoCRM podczas migracji lub pracy równoległej
- GitLab i zadania programistyczneŁączy commity i merge requesty z GitLab z zadaniami oraz przenosi zadania do weryfikacji (review)
Zacznijmy razem
Opowiedz nam, jak działa Twoja firma.
Pokażemy Ci, jak może wyglądać system, który przejmie część tej pracy.
Umów konsultację