asdasdsda
API-Benutzer anlegen
Für die Kommunikation zwischen n8n und venabo wird ein spezieller Benutzer benötigt, der ausschließlich für API-Zugriffe verwendet wird und über die entsprechenden Rechte verfügt. Öffnen Sie dazu die Benutzerverwaltung in venabo und legen Sie einen neuen Benutzer an. Achten Sie unbedingt darauf, als Benutzertyp „API“ auszuwählen, da nur dieser Typ automatisch einen API-Token erzeugt und für die maschinelle Kommunikation vorgesehen ist.
Nachdem der Benutzer angelegt wurde, vergeben Sie die Berechtigungen für genau die Bereiche, auf die später aus n8n zugegriffen werden soll – beispielsweise Adressen, Projekte oder Zeiten. Welche Berechtigungen Sie auswählen, hängt vollständig von den geplanten Workflows ab.
Im selben Dialog müssen Sie außerdem die Option „Content-Hash aktivieren“ deaktivieren, da dieser Mechanismus für die API-Authentifizierung nicht benötigt wird und zu unerwarteten Zugriffsfehlern führen kann.
Stellen Sie abschließend sicher, dass der Benutzer als „Aktiv“ markiert ist, damit venabo eingehende API-Anfragen akzeptiert.
Der Token ist für die spätere Einrichtung in n8n erforderlich und sollte unbedingt an einem sicheren Ort notiert werden.
Workflow in n8n anlegen
Nachdem der API-Benutzer in venabo vorbereitet wurde, wechseln Sie zu n8n und erstellen dort einen neuen Workflow. Öffnen Sie die n8n-Oberfläche und beginnen Sie mit einem leeren Workflow, der später die Kommunikation mit der venabo-API übernehmen wird. Der Einstieg erfolgt in der Regel über den automatischen Startpunkt, der bereits sichtbar ist. Von dort aus ziehen Sie per Drag-and-Drop einen neuen HTTP-Request-Knoten in die Arbeitsfläche.
Dieser Knoten bildet das Herzstück der Verbindung und sorgt dafür, dass n8n Anfragen an venabo senden kann. Sobald der neue Knoten platziert wurde, können Sie ihn durch einen Doppelklick öffnen und mit der Konfiguration beginnen.
HTTP-Request-Knoten konfigurieren
Im geöffneten HTTP-Request-Knoten tragen Sie zunächst die URL ein, an die die Anfrage gesendet werden soll. Falls Sie zum Beispiel Adressdaten aus venabo abrufen möchten, verwenden Sie zum Beispiel die Adresse
https://IHRSERVER.venabo.cloud/api/v1/addresses.
Diese URL verweist auf den entsprechenden Endpunkt der venabo-API, der eine Liste der hinterlegten Adressen bereitstellt.
Eine ausführliche Beschreibung der verfügbaren Endpunkte finden Sie hier: https://IHRSERVER.venabo.cloud/api/v1/docs
Im nächsten Schritt geht es darum, die richtige Authentifizierung einzurichten. Da venabo keine herkömmliche Benutzer-/Passwort-Authentifizierung nutzt, sondern ausschließlich über einen HTTP-Header authentifiziert, muss der Authentifizierungstyp im n8n-Knoten auf „Generic Credential Type“ gestellt werden. Innerhalb dieser Auswahl wählen Sie die Variante „Header Auth“. Dadurch weist n8n den Knoten an, künftig automatisch den hinterlegten Token im HTTP-Header zu übermitteln.
Damit der Header korrekt übergeben wird, legen Sie über die Credential-Verwaltung von n8n ein neues Credential-Set an. In diesem definieren Sie einen Header mit dem Namen x-api-token und tragen als Wert den API-Token ein, den Sie zuvor aus venabo kopiert haben. Sobald das Credential gespeichert wurde, kann der HTTP-Request-Knoten es nutzen und sendet den Token bei jeder Anfrage automatisch mit.
Verbindung testen
Sobald die URL und die Authentifizierung eingerichtet wurden, können Sie die Verbindung unmittelbar testen. Nutzen Sie hierfür die Schaltfläche „Execute Node“ innerhalb des HTTP-Request-Knotens. n8n führt nun eine Anfrage an venabo aus und zeigt das Ergebnis direkt im Ausgabebereich an. Wenn alles korrekt eingerichtet wurde, erscheint dort eine strukturierte Ausgabe der Daten, die der API-Endpunkt zurückliefert – im Beispiel also die Liste der Adressen aus venabo.
Sollte die Verbindung hingegen fehlschlagen, zeigt n8n aussagekräftige Fehlermeldungen an, etwa bei einem fehlenden Token oder wenn der API-Benutzer nicht über ausreichende Rechte verfügt. In solchen Fällen lohnt sich ein erneuter Blick auf die vergebenen Rechte oder auf den korrekt eingetragenen Token. Wenn die Anfrage erfolgreich abgeschlossen wurde, wissen Sie, dass die Verbindung steht und n8n künftig zuverlässig Daten aus der venabo-API abrufen kann.