Perk nutzt die Yokoy-API für das Ausgabenmanagement. Die Yokoy-API ist eine REST-API, mit der Konten Ausgaben einreichen, Transaktionen einsehen und Rechnungen in Perk verwalten können. Nur Kontoadministratoren können die Zugangsdaten für die Yokoy-API anfordern.
Tipp: Neu bei der Perk API? Sehen Sie sich den Perk Developer an (nur in englischer Sprache verfügbar).
API-Zugangsdaten sind kontobezogen. Das bedeutet, dass sie Berechtigungen zum Ändern von Stammdaten für verschiedene juristische Personen besitzen.
Wenn Sie API-Credentials anfordern, erhalten Sie die Client-ID und das Client-Secret, die verwendet werden, um ein Zugangs-Token für die Perk-API zu erzeugen. Das generierte Zugriffs-Token muss für die Authentifizierung aller Aufrufe der API verwendet werden. Sie finden diese Informationen oben rechts unter Developer tools > Spend tools.
Um ein Zugangs-Token zu erstellen, siehe Authentifizierung und Autorisierung. Die API-Credentials sind für die gesamte Organisation gültig, unabhängig davon, welche Benutzerin oder welcher Benutzer die Anfrage einreicht.
Sie können die API-Credentials im Tab Access credentials erzeugen.
API-Credentials erzeugen
So erzeugen Sie API-Credentials für die Perk-API:
- Gehen Sie zu Developer tools > Spend tools. Öffnen Sie den Tab Access credentials, und klicken Sie auf Generate credentials, um neue API-Credentials zu erstellen.
-
Wählen Sie OAuth-Zugangsdaten und klicken Sie auf Credentials erzeugen.
- Geben Sie eine Kennzeichnung ein, um die API-Credentials zu beschreiben. Die Kennzeichnung hilft Ihnen, die Anmeldeinformationen zu identifizieren. Die Kennzeichnung muss eindeutig sein. Sie können erst fortfahren, wenn Sie eine eindeutige Kennzeichnung eingegeben haben. Klicken Sie anschließend auf Weiter.
- Kopieren Sie die Client-ID und das Client-Secret und speichern Sie diese sicher (z. B. in einer geschützten Datei). Die Credentials sind einmalig und können nicht wiederhergestellt werden. Bewahren Sie sie an einem sicheren Ort auf, damit Sie sie später erneut verwenden können. Um fortzufahren, müssen Sie bestätigen, dass Sie die Client-ID und das Client-Secret kopiert haben.
API-Credentials laufen nicht ab. Sie können die Credentials während dieser Zeit jederzeit widerrufen. Wenn Sie Ihre API-Credentials verlieren, müssen Sie den Zugang widerrufen und neue Credentials erstellen.
Sie können mehrere API-Credentials für die Verwendung in verschiedenen Anwendungen erstellen. API-Credentials werden nicht automatisch widerrufen, wenn Sie mehr als ein Set von Credentials erstellen.
Auf der Registerkarte „Entwickler“ werden alle API-Credentials angezeigt, die erstellt oder widerrufen wurden, einschließlich der Benutzerin oder des Benutzers, die bzw. der die Daten angefordert hat, sowie des Datums, an dem sie angefordert wurden.
Zugriff widerrufen
So widerrufen Sie den durch die API-Credentials gewährten Zugriff:
- Klicken Sie auf der Registerkarte „Entwickler“ auf die Aktion Zugang widerrufen.
- Klicken Sie auf Zugang widerrufen, um die Credentials zu entfernen.
Vorsicht: Wenn der Zugang widerrufen wird, können andere Anwendungen oder Skripte, die dieses Token verwenden, nicht mehr auf Perk zugreifen. Daraufhin werden die API-Credentials auf der Entwicklerseite mit dem Status Widerrufen, dem Namen der Benutzerin oder des Benutzers, die bzw. der sie widerrufen hat, sowie dem Widerrufsdatum angezeigt.