Documentatie API v1

Het doel van feedback

Ook al gebruiken we meerdere (officieële) databronnen om tot een up-to-date database te komen, is er de mogelijkheid eigen adressen toe te voegen die direct beschikbaar komen voor jouw account in de Autocomplete API.

De spelregels

Om gebruik te kunnen maken van deze methode dient u volgens de Wet bescherming persoonsgegevens (Wbp) in uw privacy statement of algemene voorwaarden een dergelijke tekst opgenomen te hebben:

"Webwinkel XYZ zal uw persoonlijke gegevens niet aan derden verkopen en zal deze uitsluitend aan derden ter beschikking stellen die zijn betrokken bij het uitvoeren van uw bestelling.

In plaats van bovenstaande tekst is een expliciete opt-in na het invullen van de adresgegevens door de klant ook voldoende.


Voorbeeldcode van de feedback methode

Het gebruik van deze methode als voorbeeld in verschillende talen:

We moedigen u aan om voorbeeldcode aan te vragen in de taal van uw voorkeur. In de tussentijd wilt u misschien kijken naar de autocomplete methode, die al in vele talen is gedemonstreerd.


Feedback

Ook al gebruiken we meerdere (officieële) databronnen om tot een up-to-date database te komen, is er de mogelijkheid eigen adressen toe te voegen die direct beschikbaar komen voor jouw account in de Autocomplete API.

Verplichte parameters

  • nl_sixpp: geef de postcode op.
  • street: geef de straat op.
  • streetnumber: geef het huisnummer op.

Optionele parameters

  • extension: geef de huisnummertoevoeging op.
  • claim: geef een reden op.

Resultaat voorbeeld

/v1/feedback?auth_key=YOUR_AUTH_KEY&nl_sixpp=9999ZZ&street=knolweg&streetnumber=99

Deze aanvraag geeft het volgende resultaat:

{
  "status": "ok",
  "results": []
}

Meer voorbeelden van de feedback methode.

Foutmeldingen

  • Parameter nl_sixpp is required
    Geef de parameter ‘nl_sixpp’ mee aan de webservice. Dit mag zowel in de URL (GET) als in de body (POST).
  • Invalid nl_sixpp format
    Het formaat dient te bestaan uit 4 cijfers en 2 letters. Extra spatiëring en gebruik van hoofd- of kleine letters worden automatisch gecorrigeerd.