Je Rentman account heeft al een aantal bestaande integraties. De Rentman (public) API geeft je de mogelijkheid om zelf integraties met andere software te bouwen. In dit artikelen geven we een algemeen overzicht van de Rentman API en leggen we je uit hoe je deze kunt gebruiken.

Let op: het gebruik van de API vereist technische of programmeer kennis en ervaring. In het geval je hier niet zelf over beschikt raden we je aan om contact op te nemen met een externe ontwikkelaar of derde partij die je hierbij kan ondersteunen. Ons Support team is niet op dit gebied getraind en kan je niet helpen met de implementatie van deze API.

.

Wat is een API?

Een API (Application Programming Interface) is een "koppeling of communicatie protocol tussen een 'client' en server".

Met andere woorden, het is een wijze waarop data van een stuk software naar een ander stuk software overgezet kan worden.

Je API-token verkrijgen

Om de Rentman API te gebruiken moet je eerst een API-token genereren. Deze token is gepersonaliseerd en wordt gebruikt voor authenticatie van de API - net als een wachtwoord. Deel deze code NIET met andere partijen (zie ook ons hoofdstuk over Veilig gebruik van de Rentman API). Let op: de API-token heeft een geldigheid van 5 jaar. Na deze 5 jaar genereer je de token opnieuw.

Om je token te genereren:
1. Ga naar Configuratie > Account > Extensies.
2. Klik op Activeer als je token gedeactiveerd is.
3. Gebruik de getoonde token.

Je kan dit token nu gebruiken voor het bouwen van je API integraties. Als je een nieuwe token wilt genereren kan je altijd op Hergenereer token klikken. De oude token zal dan direct vervallen.

Rentman Public API Documentatie

Lees onze Rentman API Documentatie (in het Engels) voor meer informatie over authenticatie, headers, querying en de beperking van onze publieke API. Je zult hier ook alle benodigde voorbeeldcode vinden voor de mogelijke calls.

Veilig gebruik van de Rentman API

API tokens geven toegang tot je Rentman account. Deze token is dus vertrouwelijk en moet net als wachtwoorden als zodanig behandeld worden. Volg onderstaande regels voor veilig gebruik van jouw API token:

• Voorkom blootstelling van je token aan publieke partijen (zoals in screenshots of videos). Let op: het 'blurren' of vervagen van deze token is niet altijd voldoende. Zorg ervoor dat je de 'knip' functionaliteit van je grafische software gebruikt om zodoende de data volledig te verwijderen.
• De-valideer je oude token na gebruik als je tóch een token moet delen, bijvoorbeeld voor het laten bouwen van integratie.
• Verstuur je API token nooit per e-mail. In het geval er wordt ingebroken op jouw e-mail account geeft dit direct toegang tot jouw Rentman account.
• De toegang van de API-token wordt bepaald door de gebruikersrol van de gebruiker die de token heeft gegenereerd.