Przejdź do treści

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.

  1. 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.

  2. 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.

  3. 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ć.

  4. 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.

  5. 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.

  1. 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ą.

  2. 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.

  3. 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.

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ę