Channel Status

Channel Status

Introduction

As part of the Addressable TV solution, Icareus Suite also provides with it an independent microservice that can be used to set and get the current status of broadcast channels. The channel status(es) can be set or updated from the head-end based on any applicable criterion or trigger. Icareus Playout includes built-in support for updating the channel status of any channel configured to have this feature. However, it's also possible to deploy this service independently and optionally integrated with any head-end systems or any environments.

Updating the status

A status update is done by sending a simple HTTP POST request to the API.

API Call

POST, /status

Parameter Type Info 
channel String Name of channel 
status String PROGRAM or COMMERCIAL
token 
String MD5 hash from string: channel+":"status":"+"privatekey" 

Sample via command line

curl --data "channel=MyChannel&status=COMMERCIAL&token=9d1542e307d74bd50ec8000fd7988eb7" https://server.address/status

Response

Text response (200): OK
Text response (404): ERROR

CHECKING THE STATUS

A status update is done by sending a simple HTTP GET request to the microservice.

API CALL

GET, /status

Parameter Type Info 
channel String Name of channel 

EXAMPLE USING COMMAND-LINE

curl http://server.address/status?channel=MyChannel

RESPONSE

Text response (200): COMMERCIAL
Text response (200): PROGRAM
Text response (404): ERROR

CHANNEL STATES

The supported values for channel states at the moment are PROGRAM and COMMERCIAL