Tracking_Subscribe

POST Action

post/skynet/subscribe

Request body

idstring

Specify a custom ID for the subscription. It can be used to reference a given subscription in the downstream applications / systems.

action'TRIP_SUBSCRIBE' | 'TRIP_UNSUBSCRIBE' | 'HEARTBEAT' required

Specify the behavior that needs to be achieved for the subscription. Following values are accepted:

TRIP_SUBSCRIBE: Enable a trip subscription.
TRIP_UNSUBSCRIBE: Unsubscribe from a trip
HEARTBEAT: Enable heartbeat mechanism for a web-socket connection. The action message need to be sent at a frequency higher than every 5 mins to keep the connection alive. Alternatively, users can chose to respond to the ping frame sent by web socket server to keep the connection alive. Refer to connection details for more details.

Response

idstring

Subscription ID as provided in the input action message.

statusstring

Status of the action. It can have only two values - "success" or "error".

errorstring

Returns the error message when status: error. Otherwise, response doesn't contain this field.

timestampinteger

Returns the UNIX timestamp, in milliseconds format, when the web-socket returns the action response.

Changes

Changed in 3 of the 15 revisions of this API.99

Jul 31, 20257ee76f0ff67933See the full diff
- ▲
  removed the enum value HEARTBEAT of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value TRIP_SUBSCRIBE of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value TRIP_UNSUBSCRIBE of the request property
  request-property-enum-value-removed
- ○
  added the new HEARTBEAT enum value to the request property
  request-property-enum-value-added
- ○
  added the new TRIP_SUBSCRIBE enum value to the request property
  request-property-enum-value-added
- ○
  added the new TRIP_UNSUBSCRIBE enum value to the request property
  request-property-enum-value-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 31, 2025a800b73f11c133See the full diff
- ▲
  removed the enum value HEARTBEAT of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value TRIP_SUBSCRIBE of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value TRIP_UNSUBSCRIBE of the request property
  request-property-enum-value-removed
- ○
  added the new HEARTBEAT enum value to the request property
  request-property-enum-value-added
- ○
  added the new TRIP_SUBSCRIBE enum value to the request property
  request-property-enum-value-added
- ○
  added the new TRIP_UNSUBSCRIBE enum value to the request property
  request-property-enum-value-added
Jul 30, 2025b79d96775b1333See the full diff
- ▲
  removed the enum value HEARTBEAT of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value TRIP_SUBSCRIBE of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value TRIP_UNSUBSCRIBE of the request property
  request-property-enum-value-removed
- ○
  added the new HEARTBEAT enum value to the request property
  request-property-enum-value-added
- ○
  added the new TRIP_SUBSCRIBE enum value to the request property
  request-property-enum-value-added
- ○
  added the new TRIP_UNSUBSCRIBE enum value to the request property
  request-property-enum-value-added

Full history