Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

...

  • 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:
    • 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