Check present users
Retrieve UUIDs and state information (hereNow
) for subscribed devices on a specific channel.
Path Parameters |
---|
sub_key string — REQUIREDYour app's subscribe key from Admin Portal. Example:
|
channel string — REQUIREDThe channel name to perform the operation on. In the context of Presence, this parameter relates to a channel for which the new state will be applied or the existing state will be returned. Verify that channels are comprised of valid characters. You can use a single channel or multiple channels separated by a comma. Example:
|
Query Parameters |
---|
channel-group stringComma-separated list of channel group names to perform the operation on. In the context of Presence, this parameter relates to channel group name(s) to which you subscribe. You may subscribe to channels, channels and channel groups, or just channel groups. Example:
|
disable_uuids integerIf |
state integerIf Example:
|
limit integerLimit the number of results returned. Set |
offset integerStarting position of results to return, used for pagination. |
auth stringString which is either the auth key (PAM v2) or a valid token (Access Manager) used to authorize the operation if access control is enabled. Example:
|
callback stringThe JSONP callback name to wrap the function in. Example:
|
uuid string — REQUIREDA UTF-8 encoded string of up to 92 characters used to identify the client. Example:
|
signature stringSignature used to verify that the request was signed with the secret key associated with the subscribe key. If Access Manager is enabled, either a valid authorization token or a signature are required. Check Access Manager documentation for details on how to compute the signature. |
timestamp integerUnix epoch timestamp used as a nonce for signature computation. Must have no more than ± 60 seconds offset from NTP.
Required if |
Responses | ||||||
---|---|---|---|---|---|---|
200 OK
|