TSX

Time Synchronization Extension service (TSX) provides the reference time to the endpoints connected to the Kaa platform.

Interfaces

TSX uses 4/ESP over NATS to exchange messages with endpoints via the communication service.

TSX interfaces diagram

Request and response format

To make a basic timestamp request the endpoint must send a message with an empty payload to TSX via the communication service. TSX responds with a message that contains a JSON-encoded response with the UTC timestamp in milliseconds, for example:

{"timestamp":1234567890000}

The endpoint may also submit a request with a non-empty, JSON-formatted payload to specify its IANA Time Zone. For example:

{"timezone":"Pacific/Easter"}

In case the time in the requested timezone does not match UTC (at the time of the request), TSX extends the resonse payload with the relative offset of the requested timezone from UTC in seconds. For example:

{"timestamp":1530464400000,"offset":-21600}