Custom data topics can be defined allowing users to subscribe to various location data streams.
To publish your data onto cells first create a topic to collect the data.
The following requests are authenticated by providing your api key in the
https://map.unl.global/developer to create an apikey.
Create a topic
Publish data to topic
Publish data onto a unl location. The
Data field can consist of any json object. Any active subscriptions on this location and topic will recieve a webhook request with the published data.
Subscribing to data
It is possible to subscribe to a topic for a particular location. When an event occurs within the subscribed area, the event data will be sent to the provided webhook address via a
A custom webhook header can be configured for each subscription, this is useful in cases where the webhook endpoint is protected by an authentication key.
SecretToken may be set per topic. If provided, an additional header
unl-signature will be present with a hash signature than can be used to verify that the data came from unl and was not tampered with. The signature is calculated by conatenating the timestamp, secret token, and payload, then creating a sha256 hexidecimal hash. The example nodejs program below demonstrates how to revieve and verify messages.
Example webhook endpoint with signature validation