Um mit der API zu interagieren, benötigst Du einen gültigen API-Schlüssel. Dieser Schlüssel fungiert als sichere Brücke zwischen Deinen technischen Systemen und den Daten von Leadfeeder und stellt sicher, dass nur autorisierte Anfragen verarbeitet werden.
So generierst Du einen API-Schlüssel
Navigiere zu Deinen Einstellungen: Melde Dich in Deinem Leadfeeder-Konto an.
Klicke auf das Zahnrad-Symbol für Einstellungen in der linken Navigationsleiste.
Gehe zu Persönlich und API-Schlüssel: Suche im Einstellungsmenü auf der linken Seite den Abschnitt „API-Schlüssel“ unter Deinen persönlichen Einstellungen und klicke darauf.
Erstelle einen neuen API-Schlüssel: Klicke auf die Schaltfläche „Neuen API-Schlüssel erstellen“. Du wirst aufgefordert, dem Token einen Namen zu geben. Nachdem Du ihn benannt hast, wird sofort ein neuer Token generiert. Aus Sicherheitsgründen kannst Du den vollständigen Token nur einmal sehen. Kopiere ihn also und bewahre ihn an einem sicheren Ort auf.
Berechtigungen verstehen
Die Leadfeeder-API ist einfach und dennoch sicher gestaltet. Derzeit werden die Berechtigungen wie folgt verwaltet:
Benutzerbasierter Zugriff: Der API-Schlüssel übernimmt dieselben Berechtigungen wie der Benutzer, der ihn erstellt hat. Wenn Du in der Leadfeeder-Benutzeroberfläche Zugriff auf drei verschiedene Zielfirmen hast, kann Dein API-Schlüssel auch auf die Daten dieser drei Zielfirmen zugreifen.
Obligatorische Account-ID: Um sicherzustellen, dass Du Daten aus der richtigen Quelle abrufst, erfordern die meisten API-Anfragen eine
account_idals obligatorischen Parameter.
Best Practices für die Sicherheit
Dein API-Schlüssel ist eine sensible Anmeldeinformation. Wenn er kompromittiert wird, könnten unbefugte Dritte auf Deine Daten zugreifen. Befolge diese Richtlinien, um Deine Integration sicher zu halten:
Gib niemals Schlüssel weiter: Teile Deinen API-Schlüssel nicht in öffentlichen Foren, Support-Tickets oder unverschlüsselten E-Mails.
Verwende Umgebungsvariablen: Vermeide es, Deinen API-Schlüssel direkt in den Quellcode Deiner Anwendung zu schreiben. Verwende stattdessen Umgebungsvariablen oder einen sicheren Tresor.
Widerrufe ungenutzte Schlüssel: Wenn ein Schlüssel nicht mehr benötigt wird oder Du vermutest, dass er preisgegeben wurde, lösche ihn sofort aus Deinen Einstellungen. Nach dem Löschen funktioniert der Schlüssel sofort nicht mehr.
Technische Einrichtung: Wir empfehlen, die ersteinrichtung von jemandem mit technischem Wissen (z. B. einem Entwickler) durchführen zu lassen, um sicherzustellen, dass Header und Authentifizierung korrekt konfiguriert sind.
Fehlerbehebung bei Authentifizierungsfehlern
Wenn Du einen 401-Unauthorized-Fehler erhältst, überprüfe bitte Folgendes:
Header-Format: Stelle sicher, dass Dein Schlüssel im
x-api-key-Header übergeben wird.
Fehlende Parameter: Überprüfe, ob Du die erforderliche
account_idin Deiner Anfrage angegeben hast.