KoppelingenRentman
Rentman koppelen aan je website.
Rentman is de software van AV- en eventbedrijven: materiaal, crew en projecten in één systeem. De API is openbaar gedocumenteerd met een OpenAPI-bestand, en er zit een endpoint in waar een aanvraag van je website rechtstreeks als projectaanvraag binnenkomt.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Rentman je oplevert.
Je materiaal op je eigen pagina’s. Materiaal met foto’s, specificaties, toebehoren en alternatieven, uit Rentman en niet uit een losse lijst.
Aanvragen komen binnen als projectaanvraag. Een bezoeker stelt een lijst samen en die staat daarna in Rentman, met het materiaal eraan.
Documentatie met een OpenAPI-bestand. Ruim driehonderd operaties, met filters, sortering en paginering die je vooraf kunt nalezen.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- REST met JSON op api.rentman.net, met filteren, sorteren, veldselectie, uitklappen van gekoppelde items tot drie niveaus diep en paginering met een cursor. Eén versie, met een OpenAPI-bestand
- Authenticatie
- JWT als bearer, aan te maken op het tabblad integraties in de Rentman-configuratie. Alleen het laatst aangemaakte token werkt
- Richting
- Beide kanten op
- Verversing
- Per aanroep; maximaal 50.000 aanvragen per dag en tien per seconde
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- Een nieuw token maken zet het oude uit. Rentman zegt het zo: alleen het laatst aangemaakte token is geldig, en bij het opnieuw genereren werkt het vorige niet meer. Draaien er twee koppelingen op hetzelfde account, dan legt de tweede de eerste stil zodra iemand een token vernieuwt. Leg dus vast wie welk token gebruikt, en gebruik één token per account of aparte accounts.
- Er zijn harde limieten en ze zijn ruim. 50.000 aanvragen per dag, 10 per seconde, maximaal 20 tegelijk, en een antwoord mag niet groter zijn dan 5 MB. Die laatste haal je sneller dan je denkt als je een hele materiaalcatalogus in één keer ophaalt. Gebruik de veldselectie en de paginering; het standaardaantal is 300 per pagina en het maximum is 1.500.
- Sorteren en pagineren tegelijk kan scheef lopen. De documentatie legt het zelf uit: bij paginering gaat alleen het eerste sorteerveld mee naar de achterkant van Rentman, dus als je op twee of drie velden sorteert kunnen items op een andere pagina belanden dan je verwacht. Sorteer bij een gepagineerde lijst dus op één veld, of haal alles op en sorteer aan je eigen kant.
- Berekende velden doen niet mee met sorteren en filteren. Velden die de achterkant van Rentman uitrekent in plaats van opslaat, zijn in de documentatie gemarkeerd; daar kun je niet op filteren, en sorteren kan alleen zonder limiet. Kom je erachter tijdens het bouwen, dan zit je vast aan een ander ontwerp van de lijstpagina, dus controleer het vooraf.
Rentman koppelen
Wat je moet weten voor je begint.
Wat is Rentman?
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.
Hoe de koppeling met je website werkt
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.
Aanvragen die echt binnenkomen
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.
Waarom je materiaal op je eigen site hoort
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.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Heeft Rentman een openbare API?
Ja, met documentatie op api.rentman.net en een OpenAPI-bestand om te downloaden. Er is één versie, en bestaande koppelingen worden automatisch meegenomen als er een nieuwe komt. Filteren, sorteren, veldselectie en paginering staan er allemaal in beschreven.
Kan een aanvraag van mijn website in Rentman terechtkomen?
Ja. Er is een endpoint voor projectaanvragen waarmee je een aanvraag aanmaakt en daar het gevraagde materiaal aan hangt. Een bezoeker stelt op jouw site een lijst samen en die staat daarna in Rentman, klaar om er een offerte van te maken.
Hoe werkt de authenticatie?
Met een JWT die je aanmaakt op het tabblad integraties in de configuratie van Rentman, meegestuurd als bearer-token. Let op: alleen het laatst aangemaakte token is geldig. Maak je een nieuw token aan, dan werkt het vorige niet meer.
Hoeveel aanvragen mag mijn site doen?
Maximaal 50.000 per dag en tien per seconde, met maximaal twintig tegelijk. Een antwoord mag niet groter zijn dan 5 MB. Bij een grote catalogus betekent dat: velden selecteren en pagineren, met maximaal 1.500 items per pagina.
Mijn lijst staat in een rare volgorde, hoe kan dat?
Sorteren op meerdere velden in combinatie met pagineren geeft afwijkingen, en dat staat in de documentatie van Rentman zelf: alleen het eerste sorteerveld gaat mee bij het pagineren. Sorteer bij een gepagineerde lijst dus op één veld.
Werkt een Rentman-koppeling ook op WordPress?
Ja. We slaan het materiaal op als eigen berichttype in WordPress, zodat zoeken, filteren en losse pagina’s werken zoals de rest van je site. De aanroepen lopen vanaf de server, zodat het token niet in de paginabron staat.
Let’s work together.
Je catalogus altijd bij, en aanvragen die je kunt opvolgen.