Perk gebruikt de Yokoy API voor uitgavenbeheer. De Yokoy API is een REST API waarmee accounts uitgaven kunnen indienen, transacties kunnen raadplegen en facturen kunnen beheren in Perk. Alleen accountbeheerders kunnen API-referenties voor de Yokoy API aanvragen.
Tip: Nieuw bij de Spend API? Bekijk Yokoy-ontwikkelaar.
API-referenties zijn accountgebonden. Dit betekent dat ze: toestemmingen om stamgegevens te wijzigen voor verschillende rechtspersonen.
Wanneer u API-referenties aanvraagt, ontvangt u de client-ID en het clientgeheim. Deze worden gebruikt om een toegangstoken voor de Spend API te genereren. De gegenereerde toegangstoken moet worden gebruikt om alle API-aanroepen te verifiëren. Daarnaast hebt u de organisatie-ID voor uw account nodig. U vindt deze informatie in de rechterbovenhoek van Ontwikkelaarstools > Uitgaventools.
Om een toegangstoken in de API te genereren, zie Authenticatie en autorisatieAPI-referenties zijn geldig voor de gehele organisatie, ongeacht wie de aanroepen indient.
U kunt de API-inloggegevens genereren op het tabblad Toegangsgegevens.
API-referenties genereren
API-referenties voor de Yokoy API genereren:
- Ga naar Ontwikkelaarstools > Uitgaventools. In de Toegangsgegevens tabblad, om nieuwe API-referenties te maken, klikt u op Genereer referenties.
-
Kiezen OAuth-referenties en klik Genereer referenties.
- Voer een naam in om de API-referenties te beschrijven. De naam helpt u de referenties te identificeren. moeten uniek zijn. U kunt pas verdergaan als er een unieke naam is ingevoerd. Klik Volgende.
- Kopieer de Client-ID En Clientgeheim en bewaar ze veilig (d.w.z. in een beveiligd bestand). De inloggegevens zijn uniek en niet-herstelbaar. Bewaar ze op een veilige locatie voor later gebruik. Om verder te gaan, moet u bevestigen dat u de ID en het geheim hebt gekopieerd.
API-inloggegevens verlopen niet. U kunt de inloggegevens op elk moment in deze periode intrekken. Mocht u uw API-inloggegevens verliezen, dan moet u de toegang intrekken en nieuwe inloggegevens genereren.
U kunt meerdere API-referenties genereren voor gebruik in verschillende toepassingen. API-referenties worden niet automatisch ingetrokken als u meer dan één set referenties genereert.
Op de pagina Spend Developer Tools worden alle API-inloggegevens weergegeven die zijn gegenereerd of ingetrokken, inclusief de gebruiker die de inloggegevens heeft aangevraagd en de datum waarop deze zijn aangevraagd.
Toegang intrekken
Om de toegang die via de API-gegevens is verleend in te trekken:
- Klik op de pagina Spend Developer Tools op de actie Toegang intrekken.
- Klik Toegang intrekken om het token te bevestigen en te verwijderen.
Voorzichtigheid: Als u de toegang intrekt, hebben andere applicaties of scripts die deze inloggegevens gebruiken geen toegang meer tot Spend-gegevens. Hierdoor worden de API-inloggegevens nu weergegeven op de pagina met Spend-ontwikkelaarstools met de status Ingetrokken en de naam van de gebruiker die de machtiging heeft ingetrokken en de datum van intrekking.