The AddressCheck service consists of two separate endpoints. The first accepts a batch of customer addresses to check, whereas the second returns the results if processing has completed:
Visit the links above to see detailed information about the two endpoints.
The rest of this document describes common aspects for both endpoints.
Authentication
Both endpoints require authentication, as described here: LoginV1Â LoginV2
Concepts and notation
- uuid : a unique identifier returned by the service when a batch of customer addresses are submitted for processing. Is used later in a subsequent request to inform the service which batch is targeted.
- expiry : the results of a processed batch will expire a certain time after the request has been completed. The status of the batch is reported in the service response.
- proxy timeout : describes when the service will cancel outstanding requests to other authorities / source systems. All associated customer addresses will be marked as not supported, and the auhority will be set to NOT_PROCESSED
Configuration parameters
Describes important configuration parameters affecting use of the service.
Server side
- expiry time : 15 minutes after the request has been processed.  (TODO: Agree on / discuss this one)
- job timeout : 90 minutes (TODO: Agree on / discuss this one)30 minutes
- maximum customer addresses per request : 10'000 (TODO: Agree on / discuss this one)000
Client side
- WS-Security:
- time to live (TTL) : the TTL describes how long the SOAP request is valid, and must be specified due to the security processing.
- username / password : a valid username and password is required to access the service.
- webservice access : the user must be granted privileges to access the webservice(s)
Example application
An example application can be found here: https://bitbucket.org/distributioninnovation/demo-address-check-v2-api-java/overview