Send Mass Telemetry

📘

Use the hub_url received in the registration response as your base URL.

This API allows a called to send Telemetries for multiple devices at once. The Devices do not need to be in a parent child relationship. The main use case is when building a Cloud to Cloud integration, here a remote server can send up to 100 telemetries to Xyte directly instead of sending one by one.

Request

Multiple telemetries are send by sending an object in the request body mapping device's UUIDs to telemetry objects. Each device's access_token must be provided for each device.

{
  "b04c...94b0": {
    "access_token": "f017...afe4",
    "status": "online",
    "telemetries": {
      "speed": 10,
      "fuel": 99
    }
  },
  "c6df...a9eb": {
    "status": "offline",
    "access_token": "c237...e322",
  }
}

Response

The returned data contains a similar mapping, where each child device's UUID is mapped to a standard telemetry response (or error).

{
  "b04c...94b0": {
    "config_version": 0,
    "command": true,
    "info_version": 0,
    "new_licenses": false,
    "latest_fw_version": null,
    "latest_fw_file_id": null,
    "space_data_version": 1,
    "success": true
  },
  "c6df...a9eb": {
    "error": "Invalid access token"
  }
}