Veelgestelde vragen
Hier vind je antwoorden op de meest gestelde vragen over Nederland Postcode API.
- Wat doet de Nederlandse Postcode API?
- Met de Nederlandse Postcode API kun je eenvoudig adressen op basis van Nederlandse postcodes en huisnummers opzoeken. Dit is ideaal voor adresvalidatie, het automatisch invullen van formulieren en het verbeteren van de gebruikerservaring in je website of applicatie.
- Kan ik de API gratis gebruiken?
- Ja. Met een gratis account kun je de API kosteloos gebruiken om te testen en te integreren. Zodra alles goed werkt, kun je overstappen op een betaald abonnement.
- Wat zijn projecten?
- Projecten helpen je het API-gebruik te structureren. Je kunt per website of applicatie een apart project aanmaken, zodat verbruik en statistieken overzichtelijk per project worden bijgehouden.
- Wat is een API-key?
- Een API-key is een unieke code waarmee je toegang krijgt tot de Nederlandse Postcode API. De API-key is gekoppeld aan je account en project en wordt gebruikt om API-verzoeken te authenticeren en te registreren.
- Kan ik meerdere API-keys aanmaken per project?
- Ja, per project kun je meerdere API-keys aanmaken. Dit is handig wanneer je bijvoorbeeld aparte API-keys wilt gebruiken voor test-, staging- en productieomgevingen of voor meerdere ontwikkelaars.
- Wat is het verschil tussen een test en live API-key?
- Met een test API-key kun je de API gratis uitproberen. Een live API-key is gekoppeld aan een betaald abonnement en bedoeld voor productiegebruik. De test API-key geeft dezelfde structuur en response, maar werkt alleen voor postcodes die beginnen met 1012, 1015 of 1118. Probeer bijvoorbeeld 1118BN met huisnummer 800. Meer voorbeeldadressen vind je in de documentatie.
- Wat is de rate limit van de API?
- Elke API-key heeft een eigen rate limit, afhankelijk van het gekozen abonnement. Dit wordt uitgedrukt in het aantal verzoeken per seconde of minuut. Bij overschrijding ontvang je een foutmelding met statuscode 429 (Too Many Requests). Na een korte wachttijd kun je weer nieuwe verzoeken doen.
- Abonnement opzeggen?
- Je kunt je abonnement op elk moment opzeggen via je accountinstellingen. Na opzegging behoud je toegang tot de betaalde functies tot het einde van de lopende factureringsperiode.
- Welke betaalmethoden worden ondersteund?
- Voor betalingen maken we gebruik van Mollie. Ondersteunde betaalmethoden zijn iDEAL, creditcard (Visa, Mastercard en American Express) en automatische SEPA-incasso.
- Wat als ik mijn API-key ben kwijtgeraakt?
- Op de projectpagina kun je eenvoudig een nieuwe API-key genereren. Oude API-keys kun je daar ook intrekken zodat ze niet meer gebruikt kunnen worden.
- Waar vind ik mijn test API-key?
- Wanneer je een project aanmaakt, wordt er automatisch een test API-key voor je gegenereerd.
- Waar kan ik mijn verbruik zien?
- Op de projectoverzichtspagina zie je per project het totaal aantal API-aanroepen en het actuele verbruik per endpoint.
- Waar komt de data vandaan?
- De data is afkomstig uit officiële bronnen zoals het Kadaster, de Basisregistratie Adressen en Gebouwen (BAG) en het Centraal Bureau voor de Statistiek (CBS).
- Hoe actueel zijn de adressen?
- De adresgegevens worden maandelijks bijgewerkt met de nieuwste gegevens uit de BAG van het Kadaster. De energielabels werken we dagelijks bij.
- Worden zakelijke adressen ondersteund?
- Ja, de Nederlandse Postcode API ondersteunt zowel particuliere als zakelijke adressen.
- Kan ik de postcode database downloaden?
- Ja, je kunt in plaats van de API ook de volledige postcode database downloaden om deze offline te gebruiken of in je eigen systeem te importeren.
- Wat is de uptime van de API?
- De API heeft een uptime van 99,99%. We monitoren de dienstverlening continu en plannen onderhoud zoveel mogelijk buiten kantooruren om impact voor gebruikers te minimaliseren.
- Wat is de responstijd van de API?
- De responstijd van een API-aanroep is doorgaans rond de 50 milliseconden, afhankelijk van de serverbelasting en endpoint.
- Welk API endpoint moet ik gebruiken?
- Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om adressen op te zoeken. Een postcode en huisnummer zijn verplicht, huisnummertoevoeging is optioneel.
- Energielabel opzoeken via de API?
- Je kunt het endpoint https://api.nederlandpostcode.nl/v2/energy-label gebruiken om de actuele en historische energielabels van een adres op te halen. Een postcode en huisnummer zijn verplicht, huisnummertoevoeging is optioneel. Wil je de energielabels van een hele straat of een reeks huisnummers in één keer ophalen, gebruik dan https://api.nederlandpostcode.nl/v1/energy-label-range. Zoek je de energielabels van alle adressen binnen een straal rond een locatie, gebruik dan https://api.nederlandpostcode.nl/v1/energy-label-radius.
- Hoe vaak worden de energielabels bijgewerkt?
- De energielabels worden dagelijks bijgewerkt om de meest actuele informatie te garanderen. Aan de hand van het totaalbestand en de dagelijkse mutaties zorgen we ervoor dat de data up-to-date blijft.
- Krijg ik ook de coördinaten van een adres?
-
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om coördinaten van een adres op te halen door
attributes[]=coordinatestoe te voegen aan je API-aanvraag. - Kan ik ook de naam van de wijk opvragen?
-
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om de naam van de wijk op te halen door
attributes[]=districttoe te voegen aan je API-aanvraag. - Kan ik ook de naam van de buurt opvragen?
-
Je kunt het endpoint https://api.nederlandpostcode.nl/v1/address gebruiken om de naam van de buurt op te halen door
attributes[]=neighborhoodtoe te voegen aan je API-aanvraag. De buurt is het meest gedetailleerde niveau binnen een gemeente; elke wijk bestaat uit één of meerdere buurten. - Waarom krijg ik meerdere resultaten terug voor een adres?
- Zoeken met alleen postcode en huisnummer kan meerdere resultaten opleveren. Door een huisnummertoevoeging toe te voegen krijg je een specifiek resultaat. Bij appartementen of bedrijfsverzamelgebouwen kunnen meerdere adressen hetzelfde huisnummer delen (bijvoorbeeld 10A, 10B, etc.).
- De postcode bestaat maar ik krijg geen resultaten, hoe kan dat?
- Krijg je een 403-foutmelding, dan gebruik je waarschijnlijk een test API-key. Test API-keys werken alleen voor postcodes die beginnen met 1012, 1015 of 1118. Krijg je met een live API-key een 200-status met een lege lijst, dan bestaat de combinatie van postcode, huisnummer en toevoeging niet.
- Wat als ik mijn limiet (bijna) bereik?
- Wanneer je 80%, 90% en 100% van je maandelijkse limiet bereikt, ontvang je automatisch een e-mailmelding. Zo heb je voldoende tijd om je verbruik te controleren of je abonnement aan te passen. Bij 100% worden nieuwe API-verzoeken tot het begin van de volgende maand geweigerd. Je betaalt nooit extra kosten voor verzoeken boven je limiet.
- Kan ik de database ook offline gebruiken?
- Je kunt de adressen valideren via onze API, maar je kunt ook de gehele database downloaden met meer dan 10 miljoen adressen om deze offline te gebruiken of in je eigen systeem te importeren.
- Is er ook een PHP package beschikbaar?
- Ja, we bieden een PHP package aan die we zelf ook gebruiken. Je vindt deze op GitHub.
- Is er ook een Laravel package beschikbaar?
- Ja, we bieden een Laravel package aan die we zelf ook gebruiken. Deze is te vinden op GitHub.
- Is er ook een WordPress plugin beschikbaar?
- Ja, we hebben een plugin voor WooCommerce en Contact Form 7.
- Bieden jullie ook hulp bij integratie?
- We hebben een uitgebreide documentatie met voorbeeldcode. Maar als je er niet uitkomt, kun je altijd contact met ons opnemen. We helpen je graag verder met vragen over de API of integratie.
- Kan ik ook een factuur ontvangen?
- Ja, direct na betaling kan je een factuur downloaden. Vul bij het aanmaken van je account je bedrijfsgegevens in zodat deze automatisch op de factuur worden vermeld.
- Kan ik ook maandelijks betalen?
- Standaard zijn onze abonnementen op jaarbasis. Neem contact met ons op als je een maandelijks abonnement wilt afsluiten.
- Kan ik 1 abonnement voor meerdere websites gebruiken?
- Ja, met één abonnement kun je meerdere projecten aanmaken voor verschillende websites en/of applicaties. Het totale verbruik van al je projecten wordt bij elkaar opgeteld.
- Zijn er ook plugins beschikbaar?
- Ja, bekijk onze Plugins pagina voor een overzicht van alle beschikbare plugins. We bieden plugins aan voor populaire platforms zoals WordPress, WooCommerce, Magento en meer. Zodat je de Nederlandse Postcode API eenvoudig kunt integreren zonder dat je zelf code hoeft te schrijven.