OpenTV ENTera & OpenTV Platform Documentation

Getting all devices that are subscribed to a topic

Request

To get a list of devices that are subscribed to a topic, send a GET request to:

Bash
http://<host>:<port>/mib/v1/topics/{topicName}/devices

Headers

  • Content-Type: application/json

Mandatory fields

  • topicName (in URL) – the name of the topic

Example

This request gets a list of devices subscribed to the topic New-Videos:

Bash
http://<host>:<port>/mib/v1/topics/New-Videos/devices

Response

A successful request returns an HTTP 200 status.

An unsuccessful request returns an HTTP 404 status if the topic is not recognised.

A successful request generates a response that looks like this:

JSON
{
  "topicName": "New-Videos",
  "description": "Group to notify new Videos available to watch",
  "topicARN": "arn:aws:sns:us-east-1:113769646189:New-Videos",
  "active": true,
  "managedBy": "SNS",
  "devices": [
        {
            "deviceId": "5ca5e0ced2f2ff000118e9db",
            "deviceOS": "ANDROID7_TABLET",
            "subscriptionArn": "arn:aws:sns:eu-west-1:938499756352:GlobalTopicForAllDevices:43b0ea43-7e9f-437a-a3a5-2aeffdef0f22",
            "subscriptionStatus": true
        },
        {
            "deviceId": "5ca6dd9fc126020001b5ae74",
            "deviceOS": "ANDROID7_TABLET",
            "subscriptionArn": "arn:aws:sns:eu-west-1:938499756352:GlobalTopicForAllDevices:cb5e1f43-a7ef-4a98-9069-1024c5b7ada0",
            "subscriptionStatus": true
        }
  ]
}

See also

For full details of this API, see the DMM API documentation.