01KI und Integrationen · Modul
Automatische REST API und Webhooks
Metadatengesteuerte REST API für jede Entität, inklusive OpenAPI-Dokumentation und Webhooks
- Webhook
- API-Schlüssel
- Persönliches Zugriffstoken
- Zugriffsprotokoll
- 10
- Fähigkeiten
- 4
- Datensatztypen
- 3
- Automatisierungen
- 4
- Integrationen und KI-Tools
02Was das Modul leistet
Weniger Routine. Mehr Mehrwert.
Draivix generiert automatisch aus Metadaten eine REST API für jede Entität, ohne dass einzelne Endpunkte programmiert werden müssen. Sobald Sie ein Feld, eine Beziehung oder eine Entität hinzufügen, stehen sowohl die API als auch die zugehörige OpenAPI-Dokumentation sofort bereit – stets exakt auf die Berechtigungen des Aufrufers zugeschnitten. Ihr Unternehmen kann Onlineshop, Reporting oder eigene Anwendungen an genau dieselben Daten und Regeln anbinden, die auch in der Anwendung gelten.
- Automatisch generierte APIDie REST API – die Schnittstelle zur Anbindung externer Systeme – wird ohne Programmieraufwand für jede Entität erstellt, einschliesslich der von einem Administrator hinzugefügten Entitäten und Felder. Jedes neue Feld steht sofort zur Verfügung.
- Kontrollierte DatensatzoperationenDie API unterstützt Listenabfragen, Detailansichten, das Erstellen, Aktualisierungen sowie das weiche Löschen, bei dem ein Datensatz lediglich als gelöscht markiert wird. Berechtigungen werden sowohl auf Datensatz- als auch auf Feldebene durchgesetzt.
- Kein Überschreiben bei gleichzeitiger BearbeitungOptimistisches Sperren auf Basis der Datensatzversion verhindert, dass eine Aktualisierung eine andere überschreibt. Ändern zwei Systeme denselben Datensatz zur gleichen Zeit, überschreiben sie niemals gegenseitig ihre Daten.
- Massenänderungen in einer einzigen TransaktionErstellen Sie bis zu 100 Datensätze, aktualisieren Sie bis zu 500 und löschen Sie bis zu 100 in einem Schritt. Kombinierte Änderungen laufen in einer einzigen Transaktion ab, sodass niemals unvollständige Teilaktualisierungen gespeichert werden.
- Filterung ohne DatenlecksFiltern Sie Abfragen in fünf Notationen, mit Volltextsuche und Datumsvorlagen. Die API weist unbekannte Felder, Felder ohne Lesezugriff oder unzulässige Operatoren ab, sodass Filter niemals unautorisierte Daten preisgeben.
- Berechtigungsbezogene DokumentationDie OpenAPI-3.1.2-Spezifikation wird anhand der Berechtigungen des Aufrufers generiert. Entwickler sehen ausschliesslich die Entitäten und Operationen, zu deren Nutzung sie berechtigt sind.
- Authentifizierung auch für Agenten ausgelegtBeziehen Sie ein Token per Anmeldung mit Zwei-Faktor-Authentifizierung oder durch Signieren mit einem SSH-Schlüssel. Die zweite Option eignet sich ideal für Kommandozeilen-Agenten.
- Rate Limits und lückenlose AufrufprotokollierungDas Rate Limit beträgt 240 Anfragen pro Minute je Unternehmen und Benutzer, und das Zugriffsprotokoll zeichnet jeden Aufruf auf. So behalten Sie den gesamten API-Verkehr jederzeit im Blick.
- Daten senden, wohin Sie wollenEin Workflow versendet einen Webhook – eine automatisierte Nachricht an ein externes System – mithilfe einer benutzerdefinierten Body-Vorlage. Ziel-URLs durchlaufen einen SSRF-Schutz, damit der Server nicht für Anfragen an unautorisierte Adressen missbraucht werden kann.
- Geprüfte eingehende DatenEin eingehender Webhook empfängt Daten an einem dedizierten Endpunkt, der über ein Shared Secret im Header abgesichert ist. Jeder Aufruf wird samt Ergebnis protokolliert, sodass Sie jederzeit nachvollziehen können, was eingegangen ist.
03Funktionsweise
So funktioniert es Schritt für Schritt.
So funktioniert die automatische API
Die API benötigt keinen entitätsspezifischen Code. Ein einziger Satz generischer Routen bedient jede dem System bekannte Entität. Wenn ein Administrator eine Entität, ein Feld oder eine Beziehung hinzufügt – oder wenn ein neues Modul bereitgestellt wird –, sind API, Validierung und Dokumentation sofort verfügbar, beschränkt auf das jeweilige Unternehmen und die Berechtigungen des Aufrufers.
Im Detail lesen
Drei Prüfungen entscheiden darüber, ob eine Entität zugänglich ist: das API-Flag auf der Entität, das für das Unternehmen aktivierte Modul und die Berechtigungen des Aufrufers einschliesslich der API-Schlüssel-Richtlinie. Eine ausgeblendete Entität antwortet mit „nicht gefunden“ und gibt nicht einmal preis, dass sie existiert. Der Passwort-Tresor und die Benutzereinstellungen sind über die API nicht zugänglich. Sowohl eine angemeldete Browsersitzung als auch ein Header-Token arbeiten nach denselben Regeln und mit derselben Audit-Protokollierung wie die Anwendung.
Was die API leistet
Jede Entität unterstützt Listenabfragen, Detailabrufe, das Erstellen, vollständige oder teilweise Aktualisierungen sowie das weiche Löschen (Soft Delete). Teilaktualisierungen unterstützen optimistisches Sperren (Optimistic Locking) über die Datensatzversion und verhindern so, dass sich zwei gleichzeitige Bearbeitungen gegenseitig überschreiben. Zudem können Sie die Entitätsbeschreibung (Felder, Beziehungen, Aktionen) abfragen, eine Liste von IDs für eine gefilterte Menge abrufen (bis zu 500) und Datensätze exportieren (bis zu 1.000).
Im Detail lesen
In Massenoperationen lassen sich bis zu 100 Datensätze erstellen, bis zu 500 aktualisieren und bis zu 100 löschen; ein kombinierter Stapel aus Erstellungen, Aktualisierungen und Löschungen läuft in einer einzigen Transaktion ab. Aggregationen liefern Summen, Durchschnittswerte und weitere Kennzahlen oder nach Feldern gruppierte Anzahlen. Darüber hinaus verarbeitet die API Beziehungen (Verknüpfen, Trennen, Synchronisieren), Panels für verknüpfte Datensätze, Änderungshistorie, Audit-Protokolle, Anhänge, Aktionen für einzelne Datensätze und Auswahlen, Datensatzkonvertierungen mit Vorschau, Wertauswahllisten und die globale Suche.
Gesteuerte Status lassen sich ausschliesslich über Aktionen ändern.
Abfragen und Filter
Filter können auf verschiedene Arten formuliert werden: in Klammernotation, als ODER-Gruppen, als verschachtelter Baum, als Kurzschreibweise wie amount>=10000, als JSON oder über einen gespeicherten Filter. Volltextsuche, Sortierung, Paginierung (standardmässig 20, bis zu 200 Datensätze pro Seite), Feldauswahl sowie Eager Loading verknüpfter Datensätze werden durchgängig unterstützt.
Im Detail lesen
Die Operatoren decken Vergleiche, Enthält- und Beginnt-mit-Prüfungen, Bereiche, leere Werte, Mehrfachauswahlen, Datumsvorlagen wie „dieser Monat“ oder „letzte 30 Tage“ sowie Verknüpfungen zum aktuellen Benutzer oder dessen Team ab. Die API weist unbekannte Felder, Felder ohne Leseberechtigung oder unzulässige Operatoren ab, sodass Filter nicht dazu genutzt werden können, Daten abzutasten, die der Aufrufer nicht einsehen darf.
Dokumentation, Authentifizierung und Rate Limits
Die OpenAPI-3.1.2-Spezifikation wird zur Laufzeit aus den Metadaten und aus Sicht des Aufrufers generiert: Entitäten und Operationen, für die der Aufrufer keine Berechtigung besitzt, werden ausgelassen. Administratoren können sie im Administrationsbereich über den Scalar-Viewer durchsuchen. Validierung und Dokumentation greifen auf dieselben Definitionen zurück, sodass sie auf den abgedeckten Routen niemals auseinanderlaufen.
Im Detail lesen
Ein Token erhalten Sie durch Anmeldung (einschliesslich Zwei-Faktor-Code, sofern aktiviert) oder durch Signieren mit einem SSH-Schlüssel für Kommandozeilen-Agenten. Benutzer verwalten API-Schlüssel und MCP-Tokens in ihrem Profil. Das Rate Limit liegt bei 240 Anfragen pro Minute je Unternehmen und Benutzer; nach 10 fehlgeschlagenen Token-Versuchen pro Minute wird die IP-Adresse gedrosselt. Jeder Token-authentifizierte Aufruf wird im Zugriffsprotokoll festgehalten.
Webhooks
Ein ausgehender Webhook ist eine Aktion innerhalb eines Automatisierungs-Workflows. Er wird ausgelöst, wenn ein Datensatz geändert oder gelöscht wird, nach Zeitplan, manuell oder durch ein Domänenereignis. Dabei sendet er eine POST-, PUT- oder PATCH-Anfrage mit benutzerdefinierten Headern und einer Body-Vorlage. Die Ziel-URL wird durch einen SSRF-Schutz geprüft, Weiterleitungen sind deaktiviert und das Timeout beträgt 30 Sekunden. Anfragen sind nicht signiert; fehlgeschlagene Aufrufe werden protokolliert und nur bei atomaren Workflows oder bei Aktionen wiederholt, die so konfiguriert sind, dass sie bei einem Fehler anhalten.
Im Detail lesen
Ein eingehender Webhook empfängt Daten an einem dedizierten Endpunkt, der durch ein Shared Secret im Header geschützt ist. Die Verarbeitung übernimmt ein vom Modul registrierter Handler – etwa zur Erfassung von CRM-Leads, Anrufaufzeichnungen oder Mattermost-Push-Ereignissen. Jeder Aufruf wird samt Ergebnis protokolliert.
04Was automatisch abläuft
Automatisierungen, die Zeit sparen.
Dokumentation bleibt synchron mit der API
Die OpenAPI-Dokumentation wird zur Laufzeit aus den Metadaten und den Berechtigungen des Aufrufers generiert. Validierung und Dokumentation nutzen dieselben Definitionen, sodass abgedeckte Endpunkte niemals auseinanderlaufen.
Automatische Zugriffsprotokollierung
Jeder Token-authentifizierte Aufruf wird automatisch im Zugriffsprotokoll festgehalten. Bei der Fehlersuche in einer Integration steht Ihnen damit ein verlässlicher Audit-Trail zur Verfügung.
Webhooks im richtigen Moment ausgelöst
Ein Workflow im Automatisierungsmodul versendet einen Webhook bei Ereignissen wie Datensatzaktualisierungen oder -löschungen, nach Zeitplan oder manuell – und hält externe Systeme so in Echtzeit auf dem Laufenden.
Externe Integrationen
- Eigene Systeme anbindenJedes externe System kann sich über die REST API per verschlüsseltem HTTPS und Token verbinden. Ihr Onlineshop, Ihre Reporting-Tools oder eigene Anwendungen arbeiten mit exakt denselben Daten und Regeln wie die Hauptanwendung.
- Daten aus Drittsystemen empfangenDrittsysteme senden Daten an einen eingehenden Webhook, wo ein vom Modul registrierter Handler sie verarbeitet – etwa eingehende CRM-Leads, Anrufaufzeichnungen oder Push-Benachrichtigungen aus Mattermost.
- Workflows rufen Zielsysteme aufEin Workflow sendet eine POST-, PUT- oder PATCH-Anfrage mit benutzerdefinierten Headern und einer Body-Vorlage an ein Zielsystem und benachrichtigt das externe System, sobald eine relevante Änderung eintritt.
Was der KI-Agent übernimmt
Dieselben Regeln für KI
Sowohl der integrierte KI-Assistent als auch über MCP (Model Context Protocol) angebundene Agenten nutzen dieselben generischen Entitätsoperationen wie die REST API und setzen exakt dieselben Berechtigungsprüfungen durch.
Ein Mensch gibt frei, sobald es um Geld, Kunden oder eine Ausnahme geht.
05Häufig gestellte Fragen
Verfügt Draivix über eine REST API?
Ja. Die API wird für jede Entität automatisch aus den Metadaten generiert – einschliesslich benutzerdefinierter Felder und Entitäten, die ein Administrator hinzufügt – und berücksichtigt stets die Berechtigungen des Aufrufers.
Wo finde ich die API-Dokumentation?
Der Endpunkt /api/openapi.json liefert eine OpenAPI-3.1.2-Spezifikation, die Administratoren auch direkt im Administrationsbereich einsehen können. Sie enthält ausschliesslich die Entitäten und Operationen, für die der Aufrufer berechtigt ist.
Unterstützt Draivix Webhooks?
Ja. Ausgehende Webhooks werden über Workflows im Automatisierungsmodul versendet, während eingehende Webhooks an einem dedizierten, durch ein Shared Secret geschützten Endpunkt empfangen werden.
Wie hoch sind die Rate Limits der API?
Das Limit beträgt 240 Anfragen pro Minute je Unternehmen und Benutzer, eine Listenseite liefert bis zu 200 Datensätze und ein Export umfasst bis zu 1.000 Datensätze.
- Automatisierung und WorkflowsNo-Code-Regeln nach dem Prinzip „Wenn X passiert, führe Y aus“ sowie zeitgesteuerte wiederkehrende Datensätze
- MCP-Anbindung für externe KI-AgentenVerbinden Sie Claude Code, Codex und weitere Agenten unter konkreten Benutzerberechtigungen mit Ihrem ERP
- KI-Assistent in DraivixEin integrierter Assistent, der Daten findet, Änderungen entwirft und sie erst nach Ihrer Bestätigung speichert
- OAuth2 und OIDC für Add-onsSichere Anmeldung von Add-ons an Draivix über OAuth2 und OpenID Connect mit PKCE
- CRM und VertriebspipelineInteressenten, Leads und Verkaufschancen mit gesteuerten Phasen, Umsatzprognose und Cashflow
- Sprachassistent und Sprache-zu-TextDiktieren Sie Abfragen, transkribieren Sie Aufzeichnungen und steuern Sie Ihr ERP per Sprache über den KI-Assistenten
- WooCommerce-Onlineshop-ImportLädt Katalog, Kunden und Bestellungen aus WooCommerce und überträgt Produktbeschreibungen zurück in den Onlineshop
- EspoCRM-Migration und ParallelbetriebAbgleich und Synchronisierung von Datensätzen mit EspoCRM während der Migration oder im Parallelbetrieb
- GitLab und EntwicklungsaufgabenVerknüpft GitLab-Commits und Merge Requests mit Aufgaben und setzt Aufgaben auf Review
Starten wir gemeinsam
Erzählen Sie uns, wie Ihr Unternehmen arbeitet.
Wir zeigen Ihnen, wie ein System aussehen kann, das Ihnen einen Teil dieser Arbeit abnimmt.
Beratungstermin vereinbaren