Receive My Signals
The Receive My Signals service allows you to receive signals from VEROO. The service distuingishes three kinds of signals:
- Signals that other organisations on VEROO own. You will receive these signals if the signal owner has given you permission in VEROO to view them.
- Signals that you own that were aggregated from telematics providers by VEROO on your behalf. You will always receive these signals.
- Signals that were sent to VEROO by an application you own via the Send My Signals Service. You will not receive these signals. If you do want to receive these signals, please contact your VEROO sales representative.
The Receive My Signals service requires you to expose an HTTP endpoint in your IT system. This endpoint is called a Webhook. The Webhook must
- conform to the Webhook specification,
- be secured with HTTPS and Basic Authentication,
- be accessible via the Internet.
Consumption Control Beta
By default, your webhook will receive all your signals and all signals that have been shared with you by other organizations on VEROO. Optionally, you can have more fine-grained control over the signals you receive using the consumption control feature.
If consumption control is enabled, you can request signals to be sent to your webhook using an API. Please refer to the API documentation for more details.
Beta: Please note that this feature is currently only available to test partners.
Batch Mode
By default, the Receive My Signals service sends a single signal per message to your webhook as soon as the signal has been processed by VEROO.
Optionally, it is possible to configure the Receive My Signals service to send more than one signal to your webhook in a batch. While this introduces a delay between VEROO receiving the signal and VEROO forwarding the signal to you, it reduces the number of HTTP calls made to your webhook.
Signal Duplication and Ordering
When delivering signals to you, VEROO aims to send as many signals as possible as fast as possible to you. VEROO tries to avoid sending you the same signal twice, as well as to send signals to you in the order of their timestamps. Due to the nature of parallel processing, VEROO does not guarantee that no duplicate signal transmission occurs, and that the signals are delivered in the order of their timestamps.
If lack of duplicates and/or signal ordering are relevant for your business application, please perform de-duplication and/or ordering before submitting the signals from the Receive My Signals service to your application.
Timeouts and Retries
Please note the following behavior of the Receive My Signals service which is applied if your webhook is not reachable:
- Every call to your webhook has a timeout of 20 seconds.
- Every failed call to your webhook will be retried once. If the retry fails as well, the signals that would be sent in that call will not be forwarded to your webhook again.