A bundle which integrates http://api.postcode.nl into a Symfony application.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Controller
DependencyInjection
Resources/config
Service
KeesschepersPostcodenlApiBundle.php
README.md
composer.json

README.md

PostcodeNL Api Bundle

This bundle helps you integrating the Postcode.nl API into your Symfony project. With this integrated you can autocomplete street and places automaticly based on the user supploed postalcode and house number.

Installation

Add this bundle to your composer.json:

{
    "require": {
        "keesschepers/postcodenl-api-bundle": "dev-master"
    }
}

Second, add the bundle to your AppKernel.php:

public function registerBundles()
{
    $bundles = array(
        // ...
        new Keesschepers\PostcodenlApiBundle\KeesschepersPostcodenlApiBundle(),
    );
}

Third, you need to configure the bundle by adding the following to your config.yml:

keesschepers_postcodenl_api:
    base_url: "https://api.postcode.nl/rest/addresses"
    timeout: 5
    api_user: %keesschepers_postcodenl_api.api_user%
    api_secret: %keesschepers_postcodenl_api.api_secret%

Where you can supply api_user and api_secret directly or like the example above in your parameters.yml (recommended).

And optionally import the routing.yml into your project:

keesschepers_postcodenl_api:
    resource: "@KeesschepersPostcodenlApiBundle/Resources/config/routing.yml"
    prefix:   /

If you followed these steps correctly you should have access to the followin url:

http://your.project.local/app_dev.php/get-postalcode-details?zipcode=0000XX&address-number=XX

Advance usage

You can also use the service in your own controller:

$api = $this->get('keesschepers_postcodenl_api.api');
$response = $api->getResponseByPostcodeAndHousenumber($postalcode, $housenr);