Control Panel — API Documentation

Welcome to the new Control Panel. If you are having trouble with any functionality, or have any feedback, we would appreciate a support ticket. Additionally, you can continue to use the old control panel until it is retired in March 2019.

Stream Status API

The Stream Status API is separate from the regular ScaleEngine API. You query the origin server where you publish your streams to directly via HTTP GET requests. The API gathers information about stream status, codecs, whether a stream is being recorded, as well as allowing the user to forcing a stream to shut down. Responses from the API Module are return in XML format. To connect to the API a GET Request is sent with the necessary parameters, which include:

  • command [string] - the type of operation being requested
  • secret [string] - the secret key assigned to either the server or to the application.xml
  • app [string] - the applcation/instance to query.
  • stream [string] - the name of the stream to query

Connection URL Example


Command Description / Requirements Response
closeStream Allows requests to shutdown an active stream that is being published.

Parameters / Requirements
Requires - an active Stream Authentication Publisher to be set for the stream.
stream - name of the stream to be closed
<ScaleEngineApi>Stream Closed</ScaleEnginApi>
getStreams The getStream command allows users to retrieve the actively running streams for an Application Instance
    <Stream isRecording='true'>MyStream</Stream>
    <Stream isRecording='false'>Stream2</Stream>
getStream searches for a stream by name and returns the stream and metadata if its available

Parameters / Requirements
stream - name of the stream to search
<stream isRecording='false'>
        <major_brand>qt  </major_brand>
        <compatible_brands>qt  </compatible_brands>

Change Log

  • v1.1.3.2014.10.21 - updated result message when accessing an application that was not running
  • v1.1.2 - removed the revoke pubAuth account call when forcing a stream to close.