Zonder account
Test de API
Vul een postcode en huisnummer in. Links zie je het gevonden adres netjes opgemaakt, rechts het volledige verzoek met headers en de ruwe JSON-response, inclusief statuscode en responstijd. De console toont exact wat de echte API zou teruggeven.
Vul je een toevoeging in, dan schakelt het voorbeeld naar
/v1/addresses;
/v3/lookup accepteert alleen een geheel huisnummer.
- Straat
- Hamerstraat 19
- Postcode
- 1021JT
- Plaats
- Amsterdam
- Gemeente
- Amsterdam
- Provincie
- Noord-Holland
- Coördinaten
- 52.38488658, 4.92204151
GET https://sandbox.locatieapi.nl/v3/lookup/1021JT/19
X-Api-Key: lat_test_demo_publiek_locatieapi_sandbox
Accept: application/json
← HTTP 200 OK
Content-Type: application/json
X-RateLimit-Limit: 40
X-RateLimit-Remaining: 39
X-RateLimit-Reset: 60
X-Quota-Limit: 500
X-Quota-Remaining: 500
X-Quota-Reset: 1788220800
X-Request-Id: 6876d26c-ea3d-4164-870b-da63895ec7e3
Cache-Control: public, max-age=86400
{
"postcode": "1021JT",
"number": 19,
"street": "Hamerstraat",
"city": "Amsterdam",
"municipality": "Amsterdam",
"province": "Noord-Holland",
"location": {
"type": "Point",
"coordinates": [
4.92204151,
52.38488658
]
}
}Dit voorbeeld draait op de proefsleutel van deze pagina en is beperkt tot 40 aanvragen per minuut per IP-adres. De limiet- en bundelheaders horen bij die sleutel; met je eigen sleutel zie je hier de limieten van jouw plan.
Hoe je dit leest
- •De regel bovenaan de console is het verzoek: methode en volledige URL, daaronder de headers die meegaan.
- •Daaronder staat de response: de statuscode, de vaste responseheaders en de ruwe body.
- •De responstijd is de tijd die het opzoeken zelf kostte, zonder netwerk. In productie komt daar de verbinding bij.
- •Vul je een toevoeging in, dan schakelt het voorbeeld naar
/v1/addresses, want/v3/lookupaccepteert alleen een geheel huisnummer. - •Met "Kopieer als cURL" krijg je precies het commando dat bij het verzoek hoort dat je zojuist uitvoerde.
Foutgevallen zijn echt te zien
Vul 6545CA met huisnummer
29a in en de console toont de
400 met de problem+json-body. Zo zie je precies wat
je code moet afvangen, in plaats van het uit de documentatie te moeten afleiden.
{
"title": "Request validation failed",
"invalidParams": [
{ "name": "number", "reason": "should be integer" }
]
}Alle sandboxgevallen
In de sandbox staat een vaste set die niet verandert. Handig om je tests op te bouwen. Klik op een rij om hem hierboven in te vullen.
| Postcode | Huisnummer | Status | Resultaat |
|---|---|---|---|
| 6545CA | 29 | 200 | Waldeck Pyrmontsingel, Nijmegen, Gelderland |
| 1021JT | 19 | 200 | Hamerstraat, Amsterdam, Noord-Holland |
| 5038EA | 17 | 200 | Stationsstraat, Tilburg, Noord-Brabant |
| 3030AC | 100 | 200 | Postbus, Leusden, Utrecht. location is null |
| 6545CA | 29a | 400 | number should be integer |
| 6545C | 29 | 400 | postcode voldoet niet aan het patroon |
| 6545CA | 299 | 404 | Resource not found |