JSON REST API – version 2 – Roku Applications

Note: The version 2 API does not authenticate using a Connect user’s username and password using HTTP BASIC AUTH. Instead you create a client application using Connect’s web user interface. The client application is issued an ACCESS KEY and SECRET PASSPHRASE. These values must be passed in custom header values on every request.

URLs

Authentication

Type	Credentials	Required
Connect Custom	Connect Issued Access Key and Secret Passphrase

Examples

Using your favorite HTTP tool or library, make a GET request to https://connect.telvue.com/api/v2/roku_apps/:id replace :id with the id of the Connect Roku Application being requested and include Access Key and Secret Passphrase for the Roku Application.

cURL

The popular cURL tool comes bundled with any Linux, Mac, or UNIX operating system, and there are Windows equivalents.

Example cURL GET Request:

curl -k --header "CONNECT-ACCESS-KEY: mykey" \
--header "CONNECT-SECRET-PASSPHRASE: mysecretpassphrase" \
https://connect.telvue.com/api/v2/roku_apps/5.json

Example JSON Response:

{
  "roku_app":
    {
      "id":11,
      "name":"test 1",
      "organization_id":13,
      "organization_name":"My Test Org",
      "ga_tracking_code":"UA-TESTTEST",
      "ga_global_player_tracking_code":"staging",
      "use_detail_screen":false,
      "interaction_timeout_minutes":null,
      "use_no_interaction_timeout":false,
      "appearance":{},
      "vod_player_id":null,
      "created_at":"2016-09-13T07:09:36.858-04:00",
      "updated_at":"2016-09-13T07:09:36.858-04:00"
    }
}

Example cURL PUT Request:

curl -k -X PUT --header "CONNECT-ACCESS-KEY: mykey" \
--header "CONNECT-SECRET-PASSPHRASE: mysecretpassphrase" \
--header "Content-Type: application/json" \
-d '{"roku_app":{"name":"My New Roku App Name"}}' \
https://connect.telvue.com/api/v2/roku_apps/5.json

Example JSON Response:

{
  "roku_app":
    {
      "id":11,
      "name":"My New Roku App Name",
      "organization_id":13,
      "organization_name":"My Test Org",
      "ga_tracking_code":"UA-TESTTEST",
      "ga_global_player_tracking_code":"staging",
      "use_detail_screen":false,
      "interaction_timeout_minutes":null,
      "use_no_interaction_timeout":false,
      "appearance":{},
      "vod_player_id":null,
      "created_at":"2016-09-13T07:09:36.858-04:00",
      "updated_at":"2016-12-05T11:31:12.650-05:00"
    }
}