Channel Status Service

Channel Status Service

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 build-in support for updating the channel status of any channel configured to have this feature. However, it also possible to deploy this service independently and optionally integrated with any head-end systems or any environments.

ServiceURL

The service can be accessed via

Usage

Updating the Status

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

API CALL

POST, /status

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

EXAMPLE USING COMMAND-LINE

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

RESPONSE

Text response (200): OK

Text response (404): ERROR

privatekey is different for every customer

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

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

    • Related Articles

    • 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 ...
    • Event Recording API (ENG)

      Introduction This API is used to start and stop the recording of a Icareus Suite Channel. The system automatically links the recording to an event (e.g. Webinar) that is on the channel. The logic for linkin is the following: Warning API requires a ...
    • Managing DVB Services

      Introduction DVB Services in Icareus Playout represent TV or radio channels that are broadcasted. Note, that service properties depend on the included features of the Playout server. The DVB Services tree includes services that have been configured ...
    • Admin Dashboard: Subscriptions & Passes

      Introduction This article explains how the Subscriptions & Passes section of the admin dashboard works and what admins can do with packages. Packages are used to give users access to selected games, streams, or recordings. A package can be created as ...
    • Live Audience Analytics API

      Live Audience Analytics & APIs Below are guidelines and API information for Live analytics for channels. Live Analytics Workflow Register the device with the device registration service, and store the deviceId in localstorage and/or cookies on the ...