Local Web API

Local Web API is a simple way for integrating outside devices and trigger content in the player through a local network HTTP call.

The Local Web API is supported by screenpublishing on Android, Windows, Linux, Mac, and BrightSign players.

Important: To use the Local Web API this option must be enabled in the player settings.

enable local web api in player settings

Local Web API for Android Player 9.8.5

EndpointMethodMeaning
http://127.0.0.1:5544/trigger/{pattern}POSTTriggers the play of a campaign or a playlist which is configured with an interactivity containing the pattern {pattern}.
http://127.0.0.1:5544/campaign/current/stopPOSTStops the current content playing, skipping to the next one in the loop.
http://127.0.0.1:5544/attribute/{name}/{value}PUTSets the attribute {name} with the value {value}.
http://127.0.0.1:5544/attribute/{name}GETRetrieves the attribute named {name} as JSON, in the format {“name”: “attr_name”, “value”: “attr_value”}. If no value is set for this attribute or attribute doesn’t exist, returns {“name”: “attr_name”, “value”: null}.
http://127.0.0.1:5544/attributesGETRetrieves list of all attributes currently set as JSON, in the format {“attributes”: [{“name”: “attr_name”, “value”: “attr_value”}]}. If no value is set for an attribute, it is not listed.

Local Web API for Windows/Mac/Linux Player 9.3.9:

EndpointMethodMeaning
http://127.0.0.1:5544/trigger/{pattern}GET, POSTTriggers the play of a campaign or a playlist which is configured with an interactivity containing the pattern {pattern}.
http://127.0.0.1:5544/campaign/current/stopGET, POSTStops the current content playing, skipping to the next one in the loop.
http://127.0.0.1:5544/playback/statusGET, POSTRetrieve the playback status as JSON, in the format {“visible”: true, “playing”: true}.
http://127.0.0.1:5544/playback/showGET, POSTShows the player window. If window is already visible, nothing happens.
http://127.0.0.1:5544/playback/hideGET, POSTHides the player window. Playback still happens in the background.
http://127.0.0.1:5544/playback/startGET, POSTStarts playing content. If content is already playing, nothing happens.
http://127.0.0.1:5544/playback/stopGET, POSTStops playing content. Displays a black screen until playback is resumed.