Push

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

Web service requirements

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.

Push configurations

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.