Displaying Device Health
You can display the health status of your end users' devices in your app.
Last updated
Was this helpful?
You can display the health status of your end users' devices in your app.
Last updated
Was this helpful?
To display the healthβthat is, the online/offline statusβof your end users' devices in your app, you can use the following Seam mechanisms:
Request:
Response:
device_id
String (UUID)
ID of the device for which you want to retrieve device.connected
or device.disconnected
events
event_type
String
Event type that you want to retrieve, that is, device.connected
or device.disconnected
since
String
Desired starting event generation date and time
You must include since
or between
.
between
Set of two strings
Desired starting and ending event generation dates and times
For example:
["2024-01-01T00:00:00Z", "2024-02-01T00:00:00Z"]
You must include between
or since
.
The following example uses the List Events request to retrieve all device.connected
events for a specific device since January 1, 2024:
Request:
Response:
Seam polls connected devices and accounts every ten minutes and updates the Boolean property accordingly. Use a request to retrieve the current online/offline status of a device. Then, display the device status in your app.
You can also use the prebuilt , which includes a device status display.
When a device connection or disconnection occurs, Seam generates a or event, respectively. You can retrieve these events using a request or through and then display the corresponding status in your app.
To help you test your app against eventsβlike device disconnection or removalβthat are difficult to orchestrate in a QA environment using real devices, Seam provides a suite of simulate
endpoints that you can use in a . See .
When issuing a request to retrieve or events for a specific device, include the following parameters:
You can set up webhook endpoints to receive device.connected
and device.disconnected
events. Then, you can use the receipt of these events to display the corresponding device status in your app. For more information about configuring webhooks, see .