Polls new device notifications.

This method returns all device notifications that were created after specified timestamp.

In the case when no notifications were found, the method blocks until new notification is received. If no notifications are received within the waitTimeout period, the server returns an empty response. In this case, to continue polling, the client should repeat the call with the same timestamp value.

Request

HTTP Request

GET /device/notification/poll?deviceId={deviceId}&networkIds={networkIds}&deviceTypeIds={deviceTypeIds}&timestamp={timestamp}&names={names}&waitTimeout={waitTimeout}

Parameters

Parameter NameRequiredTypeDescription
deviceIdNostringDevice unique identifier.
networkIdsNostringComma-separated list of network unique identifiers.
deviceTypeIdNostringComma-separated list of device type unique identifiers.
timestampNodatetimeTimestamp of the last received notification (UTC). If not specified, the server's timestamp is taken instead.
namesNostringComma-separated list of notification names.
waitTimeoutNolongWaiting timeout in seconds (default: 30 seconds, maximum: 60 seconds). Specify 0 to disable waiting.

Authorization

Access JSON Web Token (GetDeviceNotification)

Request Body

Do not supply a request body with this method.

Response

If successful, this method returns array of the following resources in the response body.

Property NameTypeDescription
idintegerNotification identifier.
notificationstringNotification name.
deviceIdstringDevice unique identifier.
networkIdintegerNetwork unique identifier.
deviceTypeIdintegerDevice type unique identifier.
timestampdatetimeNotification UTC datetime (yyyy-MM-dd'T'HH:mm:ss.SSS ISO 8601).
parametersobjectNotification parameters, a JSON object with an arbitrary structure.