Stream_tags

stream_tags

This request allows you to look up all tags on a stream. They are not in any way related to session tags. A stream tag can be used to automatically start pushes or triggers depending on the tag. Which allows you to set up different workflows for streams in the same wildcard group. For example only adding recording for "some" of the current live streams.

The request looks like this:

{
  "stream_tags": "STREAMNAME",
  // Requests all tags for the given stream name

  // OR
  "stream_tags": ["STREAM1","STREAM2","STREAM3"],
  // Requests all tags for the given stream names
  // OR
  "stream_tags": true,
  // Requests all tags for all active streams
  // OR
  "stream_tags": {"STREAM":1,"STREAM2":1,"STREAM3":1}
  // Requests all tags for the given stream names
  // Value of Object is ignored

  }
}

The response to this call is the requested stream names and their tags:

{
  "stream_tags":{
    "STREAM1":["TAG1","TAG2"]
    "STREAM2":["TAG1"],
    "STREAM3":["TAG1","TAG2","TAG3"]
  }
  // Stream names without a tag will return null
  // Tags, if available, are always returned as an array
}