joostfarla / postcodeapi

Deze repository bevat het API design (op basis van Swagger) voor de nieuw te bouwen versie van de PostcodeAPI.

Postcode API 2.0

Deze repository bevat het API design (op basis van Swagger) voor de nieuw te bouwen versie van de Postcode API. Via deze repository kan er gediscussieerd worden over gewenste features en de structuur van de API. Voel je vrij om de spec te forken en via Pull Requests eventuele verbeteringen en wijzigingen aan te dragen. De meest actuele leesbare spec is hier te vinden. Admins van deze repository zijn @joostfarla en @dvh.

Wat gaat er veranderen?

Postcode API 2.0 wordt volledig van scratch ontwikkeld met de nieuwste technologieën. Hierdoor zal de nieuwe versie een enorme performance boost krijgen. Tevens streven wij naar een RESTful architectuur, waardoor adressen en postcodes los van elkaar te benaderen zijn. Een adres is immers iets anders dan een postcode + huisnummer combinatie. Door de scheiding is er nu ondersteuning voor meerdere straten binnen één postcode, huisnummer toevoegingen en letters. Ook bevat de API hypermedia links om eenvoudig door de data heen te kunnen navigeren. De brondata wordt opgeschoond en vaker en accurater ververst. De gebruikte identifiers blijven gelijk aan die van de brondata waardoor er eenvoudig met andere (overheids) datasets is te koppelen.

TODO

• Linked Data support via JSON-LD
• Verrijking van geometrie
• Koppelen van andere datasets
• Postbussen toevoegen (als iemand deze kan vinden horen wij het graag ;-))

Credits

Postcode API 2.0 wordt ontwikkeld en onderhouden door Apiwise en is een vervolg op het oorsponkelijke idee van Freshheads. Neem contact met ons op via Twitter of e-mail.