Die Authentifizierung ist der allererste Schritt, bevor irgendein Endpunkt der Lengow API verwendet wird. Sie muss bei jeder Verbindung durchgeführt werden.
Schritt 1: Client-Anmeldeinformationen
Jeder Partner, der mit der Lengow API interagieren möchte, benötigt einen Satz von Anmeldeinformationen (eine Lengow-Konto-ID, ein Zugriffstoken und ein clientSecret), die über das Lengow-Dashboard gefunden werden können.
Wo Sie diese API-Schlüssel in Lengow finden:
- Melden Sie sich bei Ihrem Lengow-Konto an
- Öffnen Sie die Einstellungsseite von Ihrem Profil > "Allgemeine Informationen"
- Finden Sie den Abschnitt mit dem Namen "A.P.I". my.lengow.io/company/api
- Sie können das Zugriffstoken und das Geheimnis kopieren, das in diesem Abschnitt angezeigt wird (siehe Bild unten)
Müssen Sie Ihre Lengow API-Schlüssel erneuern?
Um ein neues Zugriffstoken und ein neues Geheimnis zu erhalten, klicken Sie einfach auf die Schaltfläche "Erneuern" die auf dieser Seite (siehe Screenshot) vorhanden ist.
Wenn Sie diese API-Schlüssel auf Ihrer Seite verwendet haben, denken Sie daran, die veralteten zu ersetzen.
Schritt 2: Erwerb eines Zugriffstokens
Als nächstes geht es darum, ein Zugriffstoken von unserem Authentifizierungsdienst zu erwerben und dieses als Autorisierungsheader bei Anrufen an die Lengow API zu setzen.
1.Richten Sie Ihre Identifizierungsumgebung in Postman ein
Um ein Token anzufordern, beginnen Sie mit der Erstellung des Autorisierungsheaders.
- Um dies zu tun, vervollständigen Sie Ihre Client-Anmeldeinformationen mit Postman und erstellen Sie Ihre Umgebung.
2. Anforderung des Zugriffstokens
Nachdem Sie den Autorisierungsheader eingerichtet haben, fordern Sie ein Token an, indem Sie einen POST durchführen:
POST /access/get_token
Der Server gibt eine Antwort wie diese zurück:
{
"token": "1895caa9-94d3-4ff6-ac9a-5b74a0e5a1b7",
"account_id": 1
} 3. Vervollständigen Sie die Identifizierungsumgebung mit dem Zugriffstoken
Öffnen Sie Ihre Umgebung erneut in Postman und fügen Sie eine neue Variable '"LENGOW_AUTH" mit dem generierten Token hinzu (siehe Bild - Quelle: Postman)
Hinweis: Wenn die Anmeldeinformationen nicht korrekt bereitgestellt wurden, erhalten Sie eine 401 Unauthorized Antwort vom Server.
Sobald Sie Ihr Token haben, benötigen alle Ihre API-Anfragen einen aktiven Autorisierungsheader (Nutzen Sie zum Beispiel die Umgebung, die Sie in Postman erstellt haben).
