Rentman API koppelen aan je website.

Rentman is software voor bedrijven die materiaal en mensen verhuren: AV- en eventproductie, materiaalverhuur, partyverhuur en catering, crewbemiddeling en broadcasting.

Het platform bestaat uit drie delen die naast elkaar staan. Inventory voor het materiaal: wat heb je, waar is het, wat is er kapot, welke serienummers horen erbij. Crew voor de planning van mensen. En Rental voor de verhuurkant: offertes, projecten, contracten en facturen.

Dat alles in één systeem zit is precies wat een koppeling met je website interessant maakt. Wat er op je site staat is dan niet een losse productlijst die iemand met de hand bijhoudt, maar hetzelfde materiaal waarmee je plant en factureert.

De API zit op api.rentman.net en de documentatie staat er openbaar op, met een OpenAPI-bestand om te downloaden. Er is maar één versie: komt er een nieuwe, dan worden bestaande koppelingen automatisch meegenomen.

Aanmelden gaat met een JWT die je zelf aanmaakt, op het tabblad integraties in de configuratie van Rentman. Die stuur je mee als bearer-token, met een Content-Type van application/json.

Het ophalen is doordacht. Je kunt met een veldparameter zeggen welke velden je wilt, sorteren met plus en min, filteren op elke waarde met operatoren als kleiner dan en niet gelijk aan, en op lege waarden filteren. Gekoppelde items komen standaard als verwijzing terug en kun je met een uitklapparameter meteen meeladen, tot drie niveaus diep. Pagineren gaat met een cursor: je volgt het adres van de volgende pagina tot er geen meer is.

Het token maak je aan in Rentman, op het tabblad integraties onder configuratie. Het is een JWT die hoort bij de gebruiker die hem aanmaakt, en alleen het laatst aangemaakte token werkt. We spreken daarom af wie het token beheert, zodat niemand de site stillegt door voor zichzelf een nieuw token te maken.

Vul in Rentman ook de technische contactpersoon in, onder configuratie, bedrijfsgegevens en contactpersonen. Rentman gebruikt die om grote wijzigingen aan de API te melden en om contact op te nemen als een koppeling niet goed werkt.

Een aparte testomgeving noemt de documentatie niet. We beginnen daarom met alleen lezen: materiaal, toebehoren en alternatieven ophalen en daar de pagina’s van bouwen. De projectaanvraag zetten we pas aan als die pagina’s kloppen, en de eerste aanvragen lopen we samen na in Rentman.

Voor het bijhouden gebruiken we het veld updateHash. Dat verandert bij elke wijziging van een item, dus we zien meteen welke pagina’s opnieuw moeten en laten de rest staan. Hoe zo’n site in WordPress of in maatwerk wordt opgebouwd staat bij Design & Development.

Het interessantste endpoint voor een website is de projectaanvraag. Je kunt er een aanvraag mee aanmaken en daar vervolgens het gevraagde materiaal aan hangen.

Dat is een ander soort formulier dan een contactformulier met een tekstvak. Een bezoeker die drie speakers, een mengtafel en twee statieven wil, stelt die lijst samen op jouw site en die lijst staat daarna in Rentman, gekoppeld aan zijn gegevens. Jij ziet meteen waar het over gaat en kunt er een offerte van maken.

Wat er ook via de API kan: contacten en contactpersonen aanmaken, taken toevoegen, en aan de leeskant je hele materiaalbestand ophalen met toebehoren, alternatieven, serienummers en voorraadmutaties. Voor een website gebruiken we vooral het materiaal en de aanvraag; de rest hoort bij koppelingen met andere systemen.

De limieten zijn ruim: 50.000 aanvragen per dag, 10 per seconde en 20 tegelijk. De fouten zitten vaker in de aanroep zelf.

Een 400 krijg je als je een veld wilt uitklappen dat geen verwijzing is; alleen velden van het type item of link kunnen dat. Hetzelfde gebeurt als je met fields een veld van een gekoppeld item opvraagt zonder dat item ook in expand te zetten.

In een lijst laat de Rentman API sommige velden weg om de aanvraag licht te houden. Mist er op een overzichtspagina een gegeven dat op de detailpagina wel staat, vraag het dan met fields expliciet op.

Eigen velden heten custom_ met een nummer erachter. Dat nummer zegt niets over wat erin staat, dus we leggen vast welk nummer bij welk gegeven hoort. Rentman valt bij ons onder recreatie, samen met de boekingssystemen voor vrije tijd.

Veel verhuurbedrijven hebben een pdf-catalogus of een pagina met een lijst. Die is een half jaar oud, want bijwerken is handwerk en het staat nooit bovenaan de lijst.

Met een koppeling komt het materiaal uit hetzelfde systeem waar je mee werkt. Je voegt een artikel toe in Rentman en het staat op je site, met de foto, de specificaties en de toebehoren erbij. Gaat er iets uit de verhuur, dan verdwijnt het ook van je site.

En elk artikel krijgt een eigen adres. Wie zoekt op een merk en type in combinatie met huren, komt dan op jouw pagina uit in plaats van op die van een concurrent met een betere catalogus. Daar staat dan de knop die de aanvraag start, en die aanvraag komt binnen als projectaanvraag in plaats van als mailtje.