Explore the available API endpoints provided by this SPX Graphics instance. Use the expandable sections below to find the endpoints you need. See SPX Docs for an introduction to the Control API.
HOST-ID: 42e4502fForce clear to all output layers without out-animations. (Note, this does NOT save on-air state of rundown items to false, so when UI is reloaded the items will show the state before panic was triggered.) This is to be used for emergency situations only and not as a normal STOP command substitute.
A proxy endpoint for passing feed data from CORS protected datasources. (If you need to pass url parameters use %26 instead of & to separate them).
A POST version of the feedproxy endpoint. This endpoint is a helper for outgoing GET or POST requests requiring custom headers, such as Authorization or similar. Data is passed to the helper in the body of the POST request, in which url is the actual URL of the external endpoint. If the body contains a postBody -object, it will be passed to the outgoing API request as body. See principle in the example below, or search SPX Knowledge Base for more info with keyword feedproxy.
// Stringified JSON
{
"url": "https://api.endpoint.com/requiring/customheaders/",
"headers": {
"key1": "my first value",
"key2": "second value"
},
"postBody": {
"info": "If postBody is found, the outgoing request will be done using POST method, otherwise as GET."
}
}Move focus up to previous item, will not circle back to bottom when top is reached.
Move focus down to next item, will not circle back to top when end is reached.
Animate all layers (used by the current rundown) out, but does not clear layers.
Issue continue command to selected item. Notice this needs support from the template itself and does not work as play or stop.
Open rundown from project / file.
Move focus to the first item on the rundown.
Move focus to the last item on the rundown.
Move focus by ID on the rundown.
Start item by ID on the active rundown.
Continue to item by ID on the active rundown. Notice this needs support from the template itself and does not work as play or stop.
Stop item by ID on the active rundown.
Uses an invoke handler to call a function in a template. See required parameters in the example call above. JSON objects can be passed as params by urlEncoding stringified JSON. Search SPX Knowledge Base for more info with keyword invoke.
Uses SPX's messaging system to call a function in an extension. JSON objects can be passed as params by urlEncoding stringified JSON. The extension will need to implement SPX's messaging system, search SPX Knowledge Base for more info with keyword invokeExtensionFunction.
Populate template and execute a play/continue/stop -command to it. Please note the optional updateRundownItem property. updateRundownItemitemID is an optional object for forcing UI updates and persisting to defined rundown file. Please note: special charaters in values does not work at the moment! Post request body example as JSON:
// Stringified JSON
{
"casparServer": "OVERLAY",
"casparChannel": "1",
"casparLayer": "20",
"webplayoutLayer": "20",
"relativeTemplatePath": "/vendor/pack/template.html",
"out": "manual",
"DataFields": [
{
"field": "f0",
"value": "Firstname"
},
{
"field": "f1",
"value": "Lastname"
}
],
"command": "play",
"updateRundownItem": {
"updateUI": true,
"itemID": "myItemID",
"persist": true,
"project": "myFirstProject",
"rundown": "myFirstRundown"
}
}Play / stop an item from a known rundown. (Remember you can rename rundown items from SPX GUI)
Returns rundown names of a given project as an array of strings.
Returns content of a specific rundown as json data.
Creates or updates a rundown file. This can be used for example with application extensions. POST body:content must contain valid rundown JSON data, otherwise SPX controller may not be able to read it. For more info search SPX Knowledge Base with keyword api rundown/json
// Stringified JSON
{
"project": "myProjectName",
"file": "newRundown.json",
"content": {
"comment": "Playlist generated by MyApp",
"templates": [
{
"description": "First template",
"playserver": "OVERLAY",
"etc": "..."
},
{
"description": "Second template",
"playserver": "OVERLAY",
"etc": "..."
}
]
}
}Returns current memory state of web-playout layers of the server (not UI). Please note, if API commands are used to load templates, this may not return them as expected!
Returns templates and their settings from a given project.
Execute a shell script/batch file in ASSETS/scripts folder using a shell associated with a given file extension.
Returns an array of filenames fround in a given subfolder of ASSETS, such as excel.
Creates or updates a JSON file in ASSETS/json folder. This can be used for persisting arbitrary data to a JSON file. The content property of the below example gets saved to ASSETS/json/todoApp/myTodo.json. Note the subfolder property is optional.
// Stringified JSON
{
"subfolder": "todoApp",
"filename": "myData.json",
"content": {
"note": "Get these done by the end of month",
"items": [
{
"task": "Grow a beard",
"done": false
},
{
"task": "Get a haircut",
"done": true
}
]
}
}