PostcodeConnect demo

Test hieronder alle belangrijke endpoints direct via de browser. Deze demo laat niet alleen de JSON-response zien, maar ook hoe de API in echte toepassingen gebruikt kan worden: slimme zoekvelden, kaartweergave, bulk-opvragingen en codevoorbeelden.

Adres & geo Van postcode lookup tot reverse geocoding en polygonen.
Direct testen Test de mogelijkheden van onze API.
Developer-first Met snippets, request builder en response-inspectie.

Wat je hier kunt testen

Alle belangrijke flows van PostcodeConnect in één overzicht.

  • Postcode + huisnummer lookup
  • Interactieve straat autocomplete
  • Adres op coördinaten
  • Buurten en wijken met polygonen op kaart
  • Bulk en export
  • Codevoorbeelden voor developers

LET OP! Deze demo-scripts zijn alle zoekopdrachten gelimiteerd tot maximaal 25 resultaten.

Slim zoeken

Eén invoerveld dat probeert te herkennen wat je intypt: postcode, adres of coördinaten.

intelligente invoer lookupzip autocomplete reverse geocoding
Response Nog niet uitgevoerd
Nog geen response.

Postcode lookup

Zoek een exact adres op basis van postcode + huisnummer, of vraag alle adressen binnen één postcode op.

action=lookupzip postcode lookup lijst of exact item
Response Nog niet uitgevoerd
Nog geen response.
Laat huisnummer leeg om alle adressen binnen de postcode op te vragen.

Interactief adres zoeken (Autocomplete)

Typ een straat en huisnummer zoals een eindgebruiker dat zou doen. De demo zoekt eerst straten, laadt daarna huisnummers en vult vervolgens postcode en plaats automatisch aan.

getstreetsautocomplete gethousenumbers getaddressbystreetnumber
Laatste response Begin met typen
Nog geen response.
Deze demo werkt direct tijdens het typen en gebruikt dezelfde flow als een formulier-autocomplete.

Huisnummers ophalen

Vraag beschikbare huisnummers op voor een specifieke straat en plaats.

action=gethousenumbers straat + plaats huisnummerlijst
Response Nog niet uitgevoerd
Nog geen response.

Adres via straat + huisnummer

Zoek een exact adres op via straatnaam, woonplaats en huisnummernotatie.

action=getaddressbystreetnumber exact adres straat + plaats + nr
Response Nog niet uitgevoerd
Nog geen response.

Adres via coördinaten

Reverse geocoding: geef latitude en longitude mee en ontvang het dichtstbijzijnde adres.

action=getaddressbylatlong reverse geocoding lat / long kaartklik
Klik op de kaart om direct een reverse lookup uit te voeren.
Response Nog niet uitgevoerd
Nog geen response.

Adreslijst per woonplaats

Haal adressen op uit een woonplaats en filter optioneel op buurt. Je ontvangt alle adressen van de opgegeven woonplaats.

action=lookupcity woonplaats optioneel buurtfilter
Response Nog niet uitgevoerd
Nog geen response.

Woonplaatsenlijst

Zoek beschikbare woonplaatsen op met optionele zoekterm en paginatie.

action=getcities woonplaatsen zoekterm + paginatie
Response Nog niet uitgevoerd
Nog geen response.

Gebieden / buurten opvragen

Vraag buurten en wijken op binnen een woonplaats, inclusief polygonen op kaart.

action=lookupareas wijk + buurt polygon / WKT kaart
Polygonen uit geometry_wkt worden direct op de kaart gezet.
Response Nog niet uitgevoerd
Nog geen response.

Postcodegebied op kaart

Maak een benaderde polygon van alle adrespunten binnen een volledige postcode of viercijferig postcodegebied en projecteer die direct op de kaart.

action=getpostcodepolygon postcodegebied GeoJSON kaart
De polygon is een benadering op basis van adrespunten binnen de postcode.
Response Nog niet uitgevoerd
Nog geen response.

Polygon search

Teken een polygon of rechthoek van maximaal 5 x 5 km op de kaart en zoek adressen binnen het geselecteerde gebied. De huidige resultaten kun je direct als CSV exporteren in de browser.

action=polygonsearch kaart tekenen count only csv export
Gebruik linksboven de polygon- of rechthoek-tool om een gebied te tekenen. Het gebied mag maximaal 5 km breed, 5 km hoog en 25 km² groot zijn.
Teken eerst een polygon of rechthoek van maximaal 5 x 5 km. In deze demo zijn de response en CSV-export beperkt tot maximaal 25 regels.
Response Nog niet uitgevoerd
Nog geen response.

Request builder

Stel handmatig een request samen en voer deze direct uit via de proxy.

developer tool request builder snippets
Response Nog niet uitgevoerd
Nog geen response.

Bulk & CSV export

Laat zien hoe bulk-opvraging en eenvoudige export eruitzien voor zakelijke use-cases.

lookupcity bulk csv export
Nog geen bulk-opvraging uitgevoerd.
Voorbeeldresponse Nog niet uitgevoerd
Nog geen response.

API proxy op eigen server

Roep de API aan via je eigen api-proxy.php op je eigen server. Zo blijft de API-key buiten de browser en kan je zelf extra beveiliging toevoegen, zoals rate limiting, IP-restricties, origin-checks of logging.

api-proxy.php key verborgen eigen beveiliging copy/paste
Deze proxy stuurt de action en queryparameters door naar https://api.postcodeconnect.nl, voegt de Authorization: Bearer header server-side toe en retourneert daarna de upstream response. Je kan dit bestand op je eigen hosting plaatsen en naar wens uitbreiden of vergrendelen.
Aanbevolen uitbreidingen: rate limiting, allowlist op IP of domein, logging, caching en extra validatie per endpoint.
Voorbeeldbestand: api-proxy-demo.php Plaats deze file op je eigen server
<?php
declare(strict_types=1);

header('Content-Type: application/json; charset=utf-8');
header('Access-Control-Allow-Headers: Content-Type, X-Requested-With');
header('Access-Control-Allow-Methods: GET, POST, OPTIONS');
header('Cache-Control: no-store');

if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
    http_response_code(204);
    exit;
}

// Het adres van de API
$BASE_API = 'https://api.postcodeconnect.nl';

$API_KEY  = '';     // Vul hier je API-Key in


// -----------------------------
// action verplicht
// -----------------------------
$action = $_GET['action'] ?? '';
if ($action === '') {
    http_response_code(400);
    echo json_encode(['ok'=>false,'error'=>'missing_action']);
    exit;
}

// -----------------------------
// Querystring opnieuw bouwen
// -----------------------------
$params = $_GET;
unset($params['action']);

$queryString = http_build_query($params);

// Upstream URL bouwen
$upstreamUrl = rtrim($BASE_API, '/') . '/' . $action;
if ($queryString !== '') {
    $upstreamUrl .= '?' . $queryString;
}

// -----------------------------
// cURL
// -----------------------------
$ch = curl_init($upstreamUrl);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        "Authorization: Bearer {$API_KEY}",
        'X-Forwarded-For: ' . ($_SERVER['REMOTE_ADDR'] ?? '0.0.0.0'),
    ],
    CURLOPT_TIMEOUT => 15,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
]);

$response = curl_exec($ch);
$status   = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$error    = curl_error($ch);

curl_close($ch);

if ($response === false || $status === 0) {
    http_response_code(502);
    echo json_encode([
        'ok'=>false,
        'error'=>'upstream_failed',
        'detail'=>$error ?: 'timeout'
    ]);
    exit;
}

http_response_code($status);
echo $response;

Developer code snippets

Laat direct zien hoe een integratie eruitziet in JavaScript, PHP of cURL.

javascript php curl
Snippet JavaScript voorbeeld