EQ Address Lookup API provides a simple request service that will return a list of addresses from the Address Index.

You can either build and run a docker container or run in a virtual environment.

First, clone the repo:

 $ git clone https://github.com/ONSdigital/eq-address-lookup-api.git

• Pull from docker hub and run:

  $ docker run -it -p 6030:6030 -e LOOKUP_URL=https://service.uk -e AUTH_KEY=test_key onsdigital/eq-address-lookup-api

• Install Docker for your system: https://www.docker.com/
• Build and run the Docker image (make sure you are in the directory of the cloned repo):

   $ docker build -t onsdigital/eq-address-lookup-api .
   $ docker run -it -p 6030:6030 -e LOOKUP_URL=https://service.uk -e AUTH_KEY=test_key onsdigital/eq-address-lookup-api

• Make sure you have a working pipenv installation.
• Install dependencies, activate virtual environment and run:

   $ cd eq-address-lookup-api
   $ pipenv install --dev
     ...
   $ pipenv shell
     Spawning environment shell (/bin/bash). Use 'exit' to leave.
     ...
   $ FLASK_APP=application.py flask run
   [2018-04-10 14:05:11.419541] INFO: app: Logging configured
    * Serving Flask app "application"
    * Running on http://127.0.0.1:6030/ (Press CTRL+C to quit)   

To browse the API navigate a browser to http://localhost:6030. You will be redirected to the root of the API at address_api/. To search for an address type: ?q=ADDRESS/POSTCODE i.e ?q=Mont Le Grand or ?q=EX1 2PU

• The q parameter is ignored when requesting the root resource.