Trusted Web API
The fastest and most effective way to get position and sensor data, is subscribing to push data from the Trusted API server.
In order to subscribe to push service, create a new subscription making a POST
request to the Push endpoint
Once subscribed to push messages, the Trusted API server will make POST
requests to your URL, with Content-Type: application/json
, sending a UnitPushModel object in the message body, every time a unit reports to the server.
Your webservice is expected to return Http Status Code 200 (OK)
as a response
All other responses, or failure to reply, will result in the message being resent every 10 seconds. After 100 reply failures, the subscription will be suspended, meaning that only a single push message will be sent once every minute. When this single message is replied to with 200 (OK), the subscription will automatically be unsuspended, and normal push operation resumed. A warning email will be sent upon both suspension and unsuspension.
It is also possible to get all configuration changes (made via API, Mobile App or TVS website) pushed. You subscribe to the configuration push service with the requests on the Push endpoint, and the push service will send UnitModel objects. Unlike regular data push, configuration push will not retry upon failure.