A tiny wrapper around the Postcode API v2
Project description
postcodeapi is a tiny Python wrapper around the Postcode API V2.
Installation and usage
Installation
postcodeapi can be installed by running pip install postcodeapi.
Usage
Here is an example of how to use the API client. First you initialize a client with your API key, after that you use one of the four getter methods to fetch the data you need. They all return the actual JSON response converted to a Python dictionary.
# Import the PostcodeAPIClient
from postcodeapi.client import PostcodeAPIClient
# Initialize a client with your API key
client = PostcodeAPIClient(api_key="YOUR_API_KEY")
# Fetch a list of addresses (for a given postal_code and number)
# The postal_code and number parameters are optional
# The number parameter only works together with postal_code
data = client.get_all_addresses(postal_code="5038EA", number=19)
addresses = data["results"] # List of addresses
# Fetch a single address
address = client.get_address(address_id="0855200000046355")
# Fetch a list of postal codes (within a specific area)
# The area parameter is optional
data = client.get_all_postal_codes(area="5038")
postal_codes = data["results"] # List of postal codes
# Fetch a single postal code
postal_code = client.get_postal_code("5038EA")
Documentation
For more information about the data that is returned, please refer to the official API documentation. It is written in Dutch.
Running tests
To run the tests, make sure you have the dev dependencies installed, and run pytest in the root of the project.
Issues
If you have any issues with the API wrapper, please post them here. If you have issues with the actual API, please post them in the official issue tracker of Postcode API.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for postcodeapi-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f1d37ccac8854b7307202c34fa3a15703e362b987ff757001c5c30ca9f5e4142 |
|
MD5 | 0421a89312059bd90801aaa4beb46a8f |
|
BLAKE2b-256 | f79566f6f78243aed4338b207f8f7603eb9640c1e637e7e3d8ecb7337e15e6f4 |