HTTP

Base URL

The structure of the base URL will be:

http://ip-address-of-host-machine:4001/api/project-id/

For all requests to H2R Graphics, use the following base url, as seen in the Launcher window.

For example...

If the Rundown URL is http://192.168.8.153:4001/rundown/ABCD/

The base URL is http://192.168.8.153:4001/api/ABCD/

Companion

Learn how to take full advantage of this API here:

Companion

URIs

Most HTTP methods below will rely on a URI and a JSON object.

Keep in mind that the fastest way to to this information is within the Rundown, by right-clicking on any graphic that you want to show/hide/update.

Right-clicking on a graphic

Run

POST http://base_url/run

200

Clear all graphics

POST http://base_url/clear

200

Show a graphic

POST http://base_url/graphic/<graphic-id>/show

Pro tip: Right-click any graphic on your rundown to Copy "Show" URI.

200

Hide a graphic

POST http://base_url/graphic/<graphic-id>/hide

Pro tip: Right-click any graphic on your rundown to Copy "Hide" URI.

200

Update contents of a graphic

POST http://base_url/graphic/<graphic-id>/update

Pro tip: Right-click any graphic on your rundown to Copy "Update" URL and to Copy body JSON.

Request Body

Name	Type	Description
body	object

200

Update score graphic

POST http://base_url/graphic/<graphic-id>/updateScore/<team>/<level>/<type>/<amount>

team is the number of the team, likely 1 or 2. level is the score to update. Likely 1, 2, 3 or 4. type is a string depending on how the score should change. Either set, up or down. amount is the number to set, increment or decrement to score by. Example: graphic/1234/updateScore/1/1/up/10 This would affect team 1, level 1, and add 10 points to the score.

200

Text variables

Update Variable Text

POST http://base_url/updateVariableText/<variable-text-id>

Request Body

Name	Type	Description
text*	String

Example companion button for updating a Text variable

Variable list

Select a row on a variable list

POST http://base_url/updateVariableList/1/selectRow/next

Replace next with previous or <number> to select a specific row.

Outputs

Open an output with HTTP

POST http://base_url/output/<output_number>/open

Path Parameters

Name	Type	Description
output_number*	String	1, 2, 3 or 4

Speaker Timer

Run/resume a Speaker Timer

POST http://base_url/graphic/<graphic_id>/timer/run

Pause a Speaker Timer

POST http://base_url/graphic/<graphic_id>/timer/pause

Reset a Speaker Timer to it's original duration

POST http://base_url/graphic/<graphic_id>/timer/reset

Add/remove time from a running Speaker Timer

POST http://base_url/graphic/<graphic_id>/timer/jump/<amount_in_seconds>

When paused the time will be added/removed from the duration.

When playing the time will be added/removed from the active time left.

Path Parameters

Name	Type	Description
<amount_in_seconds>*	Number	10 would add 10 seconds. -10 would subtract 10 seconds.

Set the duration of the Speaker Timer and reset it.

POST http://base_url/graphic/<graphic_id>/timer/duration/<amount_in_seconds>