Add Live Channel

Creates a live channel.

Request

Request syntax:

POST /channels

Request body parameters:

Pass the following request body parameters:

Response

The response for a successful request contains the following properties:

override Dictionary

The override dictionary contains the following properties when you are overriding the live channel's source:

test_players List

The test_players list describes each test player through the following properties:

Sample Request/Response

Call the add_live_channel module (Python 3) to create a live channel. This module imports names from the api_auth module.

import json, requests, datetime, time
from api_auth import APICredentials, APIParams

class LiveChannel:
    def __init__(self):
        self.host = "https://services.uplynk.com"

    def run(self):
        """
        Create a live channel.
        """
        self._create_live_channel()

    def _create_live_channel(self):
        url = "{}{}".format(self.host, "/api/v4/channels")

        payload = {
            'desc': 'My New Live Channel', # Replace with the live channel's name.
            'slicer_id': 'mySlicer1', # Replace with the desired Live Slicer ID.
            'use_chsched': 2 # Enables scheduling.
        }

        headers = {'Content-Type': 'application/json'}

        response = requests.post(
            url, params=APIParams(APICredentials()).get_params({}), data=json.dumps(payload), headers=headers
        )

        print(response.json())

LiveChannel().run()

Response:

{
	'@id': '/channels/a6aa35d4b523498aab7227ed9510c138',
	'@type': 'Channel',
	'id': 'a6aa35d4b523498aab7227ed9510c138',
	'desc': 'My Live Channel',
	'created': '2021-04-30T16:19:48.215Z',
	'external_id': '',
	'use_chsched': 2,
	'ad_slate': '80292e78be6843fa8398827589748782',
	'blackout_slate': '860cbd66462a43b799ce044e6045f63d',
	'missing_content_slate': '48d8de0bdb0b4f2493310ad868525fb8',
	'embed_domains': '',
	'meta': {},
	'thumb_url': '',
	'slicer_id': 'MyLiveSlicer1',
	'hls_url': 'https://content.uplynk.com/channel/a6aa35d4b523498aab7227ed9510c138.m3u8',
	'dash_url': 'https://content.uplynk.com/channel/a6aa35d4b523498aab7227ed9510c138.mpd',
	'test_players': [{
			'desc': '5ExtMIB5AUzLtAAYvNF2NG',
			'id': '5ExtMIB5AUzLtAAYvNF2NG',
			'expire': None,
			'params': '',
			'whitelist': False,
			'url': 'https://content.uplynk.com/player/5ExtMIB5AUzLtAAYvNF2NGsc.html',
			'url_html5': 'https://content.uplynk.com/player5/5ExtMIB5AUzLtAAYvNF2NGsc.html'
		}
	],
	'embed_html5_player_url': 'https://content.uplynk.com/player5/32jMLROxrcW8JNFJNglmIVec.html',
	'require_drm': 1,
	'require_studio_drm': 0
}