Postcode API koppelen aan je website.

Een postcode API is een dienst die je website een adres teruggeeft op basis van postcode en huisnummer. De bezoeker vult twee velden in, je site stelt de vraag op de achtergrond, en straat en plaats staan er meteen.

De bron is bijna altijd dezelfde: de Basisregistratie Adressen en Gebouwen, de BAG, die gemeenten bijhouden en het Kadaster landelijk beschikbaar stelt. Wat verschilt is wie de vraag beantwoordt, hoe snel, tegen welke voorwaarden, en wat er nog bij komt, zoals adressen in andere landen.

Er zijn meerdere aanbieders. Postcode.nl is een veelgebruikte betaalde, met Nederlandse adressen en aanvullen voor veertien landen. postcodeapi.nu is een aparte aanbieder die toevallig "Postcode API" als merknaam gebruikt. En PostNL heeft een eigen postcodecheck voor in de checkout. Daarnaast kun je rechtstreeks bij de overheid terecht, via het Kadaster en PDOK. Wij zijn geen van deze partijen; wij bouwen de koppeling met de bron die bij jouw situatie past.

Postcode.nl is de route voor een webshop die ook in het buitenland verkoopt of die aanvullen tijdens het typen wil, zoals je dat van grote webshops kent. Je betaalt een jaarbedrag met een prijs per aanvraag, je kunt gratis testen na registratie, en er zijn kant-en-klare plugins voor onder meer WooCommerce, Magento en Shopware.

De BAG API Individuele Bevragingen van het Kadaster is gratis en geeft meer dan alleen straat en plaats: ook het verblijfsobject achter het adres, met gegevens zoals oppervlakte en gebruiksdoel. Je vraagt er een sleutel voor aan via een formulier. Er is geen aparte testomgeving, dus je test direct met je eigen sleutel op de echte gegevens.

De Locatieserver van PDOK is de route zonder drempel: open, gratis en zonder sleutel. Hij heeft een aanvulfunctie voor tijdens het typen, een vrije zoekfunctie en een opzoekfunctie, en geeft bij een adres ook coördinaten terug. Voor een eenvoudig contact- of aanvraagformulier is dat vaak genoeg.

Onze vuistregel: alleen Nederland en een gewoon formulier, dan PDOK of de BAG API. Een webshop met buitenlandse klanten of veel verkeer in de checkout, dan Postcode.nl, omdat daar een vaste snelheidslimiet en ondersteuning tegenover staan.

Het formulier stuurt postcode en huisnummer naar een endpoint op je eigen server. Die zet de invoer eerst in de goede vorm: postcode in hoofdletters zonder spatie, het huisnummer los van huisletter en toevoeging. Pas dan gaat de vraag naar de bron.

Komt er één adres terug, dan vullen we straat en plaats in en laten we de velden aanpasbaar. Komen er meerdere terug, bijvoorbeeld omdat er op hetzelfde nummer een A en een B zijn, dan laten we de bezoeker kiezen. Komt er niets terug, dan zeggen we dat ook, in plaats van stil een ander adres in te vullen.

En de bron kan uitvallen. Daarom blijft het formulier altijd gewoon in te vullen met de hand. Een koppeling die het formulier blokkeert als de API niet antwoordt, kost je meer aanvragen dan hij oplevert.

Voor zakelijke formulieren is het adres vaak niet genoeg. Met de KVK API zoek je in het Handelsregister op KVK-nummer, naam, of postcode met huisnummer, en haal je daarna het Basisprofiel of Vestigingsprofiel op: de officiële naam, de rechtsvorm, de activiteiten en het bezoek- en postadres.

De KVK API is niet gratis en niet anoniem. Je sluit een abonnement af per sleutel, betaalt per bevraging, en Zoeken zelf is gratis. Je moet ingeschreven staan in het Handelsregister en een overeenkomst tekenen; de aansluiting volgt daarna binnen enkele werkdagen. Om te bouwen is er een gratis testomgeving met fictieve bedrijven.

Wat het oplevert, zit vooral achter het formulier. Een aanvraag die met het KVK-nummer en het vestigingsadres binnenkomt, zet je direct compleet in je CRM, bijvoorbeeld in HubSpot, zonder dat iemand bedrijfsgegevens overtypt.

De overheid zet veel gegevens open, net als bij RDW Open Data, maar gratis betekent niet onbeperkt. De BAG API heeft zijn vaste grenzen per dag en per seconde. Bij de Locatieserver van PDOK staat geen getal, en dat is geen uitnodiging om er een hele database mee te vullen.

Wij bewaren daarom wat we ophalen. Een adres dat vandaag is opgevraagd, hoeft morgen niet opnieuw. Dat scheelt aanvragen, en het scheelt laadtijd voor de bezoeker.

Bij Postcode.nl en de KVK API is het omgekeerd: daar kost elke aanvraag geld. Een formulier dat bij elke toetsaanslag een vraag stelt, of een bot die het formulier duizend keer invult, zie je terug op de factuur. Een korte wachttijd voordat de aanvraag vertrekt en een simpele bescherming tegen bots horen er dus bij.

Op WordPress komt de postcodecheck in het formulier dat je al gebruikt. Een kleine uitbreiding op de server doet de aanvraag en vult de velden; de sleutel blijft op de server. Voor een WooCommerce-webshop gebruiken we waar het kan de officiële plugin van Postcode.nl, en bouwen we zelf wat die niet doet, zoals de koppeling met KVK-gegevens of de gratis BAG-route.

Op een maatwerksite in Next.js is het een eigen serverroute met een cache ervoor. Dat is de route voor een offertetool of aanmeldportaal waarin het adres meer bepaalt, zoals het werkgebied, de bezorgkosten of de vraag welke vestiging een aanvraag krijgt.

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