Introduction

The Mosart Remote Control Service (RCS) provides a REST API for controlling Viz Mosart rundowns using REST. This interface in effect duplicates some GPI/O calls (0-4) for rundown operations.

Working with the REST API

Prerequisites/Conditions

• The descriptions below of the command assume that RCS and the user work on the same machine and its name is localhost.

• The API hosted by RCS and configured to run on port 55167. This port can not be configured.

• Employs API key-based authentication where the key needs to be passed in a HTTP header called "X-API-key". See Authentication below.

• All routes under "/api/v1/command" are protected.

• All commands of this API are accessible only when RCS is running.

Swagger Documentation

• The Swagger documentation that describes every command can be found at http://localhost:55167/swagger/.

Command Descriptions

• Reload rundown

• Start/Continue rundown

• Skip Next

• Unskip Next

• Skip Next Sub Item

• Unskip Next Sub Item

• Start rundown from top

• Enable/disable rehearsal mode

• Take a template

• Trigger a DirectTake template

• Trigger Control Command

• Load Rundown

Reload rundown

The reload endpoint allows you to reload the current rundown. It will trigger a rundown reload event. I.e. the timeline will be stopped and the current rundown will be reloaded from the NRCS cache. No additional parameters.

GET api/v1/command/reload

Start/Continue Rundown

Start or continue the rundown. You can use some optional parameters - see the swagger documentation.

GET api/v1/command/start-continue

Skip Next

Skip the next item in the rundown.

GET api/v1/command/skip-next

Unskip Next

Unskip a previously skipped item in the rundown.

GET api/v1/command/un-skip-next

Skip Next Sub Item

Skip the next sub item in the rundown.

GET api/v1/command/skip-next-sub-item

Unskip Next Sub Item

Unskip a previously skipped sub item in the rundown.

GET api/v1/command/un-skip-next-sub-item

Start Rundown from Top

Restart the rundown from the first story. No additional parameters.

GET api/v1/command/start-from-top

Enable/disable Rehearsal Mode

Enable/disable/toggle rehearsal mode:

GET api/v1/command/rehearsal-mode?state=true
GET api/v1/command/rehearsal-mode?state=false
GET api/v1/command/rehearsal-mode

Take a Template

Takes the template by its type and variant (name) and which bus (optional).

GET api/v1/command/template?type={template-type}&variant={variant}&bus={preview|program}

For example,
GET api/v1/command/template?type=Camera&variant=CAM1

Here Camera and CAM1 are the current type and name of the desired template cut to program.

GET api/v1/command/template?type=Camera&variant=CAM1&bus=PREVIEW

Here Camera and CAM1 are the actual type and name of the desired template put into preview.

Trigger a DirectTake Template

Trigger a given DirectTake template. You must provide the number of desired template.

GET api/v1/command/directtake?number={number}

Trigger Control Command

Trigger a control command in Mosart.

GET api/v1/command/controlcommand/{command}?params…

Load Rundown

Load/Open a specific rundown in Mosart. This only works with MOS-based rundowns, and you have to provide the ID of the rundown that you want to open. In Vizrt’s Showmaker, you can get this ID by opening a rundown, then copying the ID from the URL.

GET api/v1/command/open-rundown?id={rundown-id}

Authentication

All commands require the special API key as a sign that the action has been authorized. This key should be passed in HTTP header called X-API-key.

Remote Control Dispatcher Service (RCS) configuration file

The RCS configuration file contains a new setting RestApi. It's value can be randomly generated to be robust and sustainable against brute-force attack. Each REST call will compare the passed in header key  X-API-key  with the value from the RestApi setting first.

%ProgramData%\Mosart Medialab\ConfigurationFiles\RemoteDispatcherServiceConfig.xml