Onderliggende pagina's
  • Postcode Service handleiding NL
Spring naar het einde van metadata
Ga nar het begin van metadata


Inhoudsopgave

Inleiding

Deze handleiding beschrijft de functionaliteiten van de Postcode service API en hoe u deze kunt gebruiken.

Contactgegevens TIG voor technische vragen

Wij kunnen het snelst reageren via ons ticketsysteem, stuur een e-mail naar:

servicedesk@tig.nl of gebruik deze link voor uitleg om via ons systeem een ticket aan te maken.

U kunt ook telefonisch uw vraag stelen via onze HQ in Amsterdam op 020 - 21 81 001 (directe technische ingang).

Installatie

Installatiestappen

De volgende gegevens zijn ter demo beschikbaar gesteld. Indien u uw eigen client_id en secure_code heeft ontvangen dient u deze te gebruiken. Mocht u niet in bezit zijn van deze gegevens dan kunt u deze bij TIG opvragen. Onderstaande gegevens kunnen gebruikt worden om de functionaliteit uit te proberen:

  • client_id = 1177
  • secure_code = 9SRLYBCALURPE2B

Deze gegevens bevatten wel een limiet. Zodra dit limiet bereikt is, is het nog wel mogelijk om een testaccount op te vragen. Neem contact op met TIG als u een test account wenst te ontvangen.


JSON calls
Voorbeeld call:
https://postcode.tig.nl/api/v3/json/getAddress/index.php?postcode=1014BA&huisnummer=37&client_id=1177&secure_code=9SRLYBCALURPE2B

Response success:

{"success":true,"straatnaam":"Kabelweg","woonplaats":"Amsterdam"}

Response failure:
{"success":false,"error":"Postcode niet gevonden"}

Voorbeeld PHP-bestand
Om de postcode service in uw omgeving te integreren is hier een eenvoudig voorbeeld in PHP weergeven:

<?php
$postcode = "1014BA";
$huisnummer = 37;
$postcodeAdres =
file_get_contents("http://postcode.tig.nl/json/?postcode=" .
$postcode . "&huisnummer=" . $huisnummer .
"&client_id=1177&secure_code=9SRLYBCALURPE2B");
						
header('Content-Type: application/json');
echo $postcodeAdres; 

Versioning van de API
Aanpassingen in de TIG API gaat volgens versioning. Nieuwe functionaliteiten in de API wordt beschikbaar gemaakt volgens onze versioning URI standaard:
https://postcode.tig.nl/api/v3 

Bij elke API wijziging wordt dit nummer verhoogd. Nieuwe wijzigingen worden waar mogelijk altijd backward compatible uitgevoerd. Wanneer een script de postcode velden in een bepaalde volgorde verwacht, of maximaal een bepaald aantal velden, zal dit in de oude versie altijd ongewijzigd blijven. Hierdoor blijft het script zonder problemen werken.

Back-up
Wij adviseren u de installatie altijd eerst op een testomgeving uit te voeren en een back-up te maken van uw omgeving voor u begint.


Veelgestelde vragen

  • Is het mogelijk om meerdere servers gebruik te laten maken van de API?
    Ja, het is mogelijk om meerdere ip-addressen toe te voegen aan uw account voor eigen gebruik (zonder wederverkoop). Neem hiervoor contact op met de technische afdeling van TIG via servicedesk@tig.nl of per telefoon op 020 - 21 81 001.
  • Is het mogelijk om de database ook zelf in house te hebben en als back-up te gebruiken?
    Ja, neem hiervoor contact op met sales@tig.nl of per telefoon op 020 - 21 81 000.
  • Wat is het maximaal aantal requests dat ik naar de API kan uitvoeren?
    Dit is afhankelijk van uw contract, standaard is 10 requests / seconden. Neem telefonisch contact op met uw accountmanager op telefoonnummer 020 - 21 81 000.
  • Als ik ondersteuning nodig ehb, op welke tijdstippen kan ik TIG bereiken?
  • Het hele jaar door, 365/7/24, ook op feestdagen op telefoonnummer 020 - 21 81 001.

Technische vereisten

Om gebruik te maken van de postcode service API dient uw omgeving te voldoen aan de minimale technische verseisten:

  • Basiskennis JSON encoding/decoding.

Release notes

V 6.0.0

Postbus resultaten worden ook meegenomen

V 5.3.1

Uitgebreide terugkoppeling foutmeldingen

V 4.3.0

Compatibiliteit PHP 5.6

V 3.2.5

Ondersteuning XML en JSON

V 2.2.0

Throttle limiting, floating IP, beschikbaarheid in regio’s US, Europa, CN

V 1.1.0

Publieke release, feedback verwerkt, stable version, live versie in webshops

V 1.0.5

Pilot klanten release, fine tuning

V 0.9.5

Initiële bèta release van de API dienst

Op de hoogte blijven?

U kunt zich als watcher aanmelden op deze pagina zodat u updates ontvangt bij wijzigingen.

Heeft u feedback? Wij horen het graag op 020-2181001 of per e-mail op servicedesk@tig.nl.

  • Geen labels