RDW API koppelen aan je website.

De RDW is de dienst die voertuigen registreert en keurt. Een deel van die registratie staat als open data online, op opendata.rdw.nl, en is voor iedereen te bevragen zonder account.

De belangrijkste set heet Gekentekende_voertuigen en heeft kenmerk m9d7-ebf2. Daar zitten bijna honderd kolommen in: kenteken, voertuigsoort, merk, handelsbenaming, vervaldatum APK, datum tenaamstelling, bruto BPM, inrichting, aantal zitplaatsen, kleuren, cilinderinhoud, massa’s, catalogusprijs, aantal wielen, Europese voertuigcategorie, tellerstandoordeel en of het voertuig WAM-verzekerd is.

Daarnaast zijn er losse sets die aan dezelfde kentekens hangen, voor assen, brandstof, carrosserie en voertuigklasse. Die haal je erbij als je ze nodig hebt, met hetzelfde kenteken als sleutel.

Het platform draait op Socrata, en dat betekent dat elke dataset een adres heeft dat je rechtstreeks kunt opvragen: opendata.rdw.nl/resource/m9d7-ebf2.json, met een kenteken als parameter erachter. Het antwoord is JSON en komt meteen terug.

Er is geen sleutel voor nodig. Je kunt een app token aanvragen en dat is voor zwaar gebruik verstandig, maar om te beginnen hoeft het niet. Dat maakt dit de enige koppeling op deze site die je vandaag kunt aanzetten zonder iemand te bellen.

Wij zetten de aanvraag altijd achter een eigen endpoint op je server, ook al is er geen sleutel te beschermen. Zo kunnen we het antwoord bewaren, opschonen en aanvullen voordat het in beeld komt, en zit je site niet vast aan het formaat waarin de RDW het toevallig teruggeeft.

1. We kiezen de datasets. Voor de meeste formulieren is Gekentekende_voertuigen genoeg; voor brandstof en uitstoot komt de set met kenmerk 8ys7-d773 erbij, met hetzelfde kenteken als sleutel.

2. We bepalen welke velden er echt in beeld komen. Met $select vraag je alleen die op, zodat het antwoord klein blijft.

3. Op je eigen server komt een endpoint dat de aanvraag doet, het antwoord opschoont en per kenteken bewaart.

4. We testen met echte kentekens, ook in de schrijfwijzen die bezoekers intypen: met streepjes, met kleine letters en met spaties.

5. Bij de livegang staat de terugval klaar, zodat het formulier werkt als de aanvraag uitblijft. Voor zwaar gebruik vragen we een app token aan.

Het duidelijkste is een formulier dat zichzelf invult. Iemand typt een kenteken en ziet meteen “Volkswagen Golf, 2019”. Dat scheelt drie keuzelijsten waarin mensen hun uitvoering niet weten, en het is precies waar een formulier bezoekers verliest. Wil je naast het kenteken ook het adres laten aanvullen, lees dan hoe we een postcode API koppelen.

Voor een garage of bandenzaak is de APK-datum de interessante: een afspraakformulier dat laat zien wanneer de APK verloopt, geeft de bezoeker meteen een reden om nu te boeken. Voor een schadeherstelbedrijf of een verzekeringsadviseur zijn het de voertuigkenmerken die anders uitgevraagd moeten worden.

En er is een derde toepassing die vaak vergeten wordt: controle. Een ingevuld kenteken dat geen resultaat oplevert, is een typefout of een voertuig dat niet in de set staat. Dat opvangen op het moment van invullen is prettiger voor de bezoeker dan een telefoontje achteraf.

Wat de RDW API niet doet is voorraad tonen. Voor de auto’s die een autobedrijf te koop heeft is het voorraadsysteem de bron, en daarvoor is er een koppeling met Hexon. Hoe kenteken, voorraad en afspraak samenkomen op een website voor je autobedrijf, lees je op die pagina.

Er zit geen factuur aan, maar er zitten wel voorwaarden aan, en die zijn ongebruikelijk genoeg om ze hier apart te noemen.

Je mag niet op je site zetten dat de gegevens van de RDW komen. Die regel staat in hun bijsluiter, onder de Creative Commons Zero-licentie, samen met het verbod om hun logo of huisstijl te gebruiken. Wie gewend is aan bronvermelding bij open data doet hier precies het verkeerde.

En er is geen enkele garantie: niet op beschikbaarheid, niet op actualiteit, en de RDW mag zonder verantwoording stoppen. Dat is geen reden om het niet te gebruiken, wel een reden om het formulier te bouwen alsof de integratie er morgen niet is. Valt hij weg, dan vult de bezoeker het zelf in en werkt de site gewoon door.

De eerste zit in het kenteken zelf. De set bevat kentekens in hoofdletters en zonder streepjes, en een vraag met kleine letters geeft een lege lijst terug in plaats van een foutmelding. Zet wat de bezoeker intypt dus eerst om voordat je de aanvraag doet. Dat hebben we zelf nagemeten op opendata.rdw.nl.

De tweede zit in de brandstofset. Een hybride auto heeft daar meer dan één regel, bijvoorbeeld een voor benzine en een voor elektriciteit. Wie alleen de eerste regel leest, laat de helft van het verhaal weg.

De derde zit in de datums. Een veld als vervaldatum_apk staat er als getal, en naast de meeste datums staat een tweede veld dat op _dt eindigt en een echte datum bevat. Gebruik dat tweede, dan hoef je zelf niets om te rekenen.

En wil je weten hoe actueel een set is: het antwoord bevat de header x-soda2-truth-last-modified, met het moment waarop de gegevens voor het laatst zijn bijgewerkt. Omdat de RDW daar geen garantie op geeft, lezen wij die mee.

Op WordPress komt het kentekenveld in het formulier dat je al gebruikt. Een kleine uitbreiding op de server doet de aanvraag en vult de andere velden, en de bezoeker kan ze nog aanpassen voordat hij verstuurt. Het antwoord per kenteken bewaren we in de database van de site.

Op een maatwerksite in Next.js is het een eigen serverroute die hetzelfde doet, met een cache ervoor. Dat is de route voor een afsprakenmodule of offertetool waarin het kenteken meer bepaalt dan een paar velden, zoals de keuze van een onderhoudsbeurt op basis van merk en datum van eerste toelating.

Formulieren en maatwerk als dit vallen bij ons onder Design & Development.