JSON REST API – version 2 – Playlist Items

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

Method URL Content Type
GET https://connect.telvue.com/api/v2/playlists/:playlist_id/playlist_items application/json
GET https://connect.telvue.com/api/v2/playlists/:playlist_id/playlist_items/:id application/json

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/playlists/:playlist_id/playlist_items replace :playlist_id with the id of the Connect Playlist being requested and include Access Key and Secret Passphrase for the Client Application from which you are making the request.

cURL

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

Example cURL GET Playlist Items Index Request:

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

Example JSON Response:

{
  "playlist_items":
    [
      {
        "id":37882,
        "playlist_id":837,
        "sequence_number":1,
        "window_start":null,
        "window_end":null,
        "playable":
          {
            "id":32262,
            "uuid":"d1027a2e-7f46-4410-a8ec-e5f54cdf42f3",
            "title":"darkknightrises-tlr2 h1080p HD",
            "short_summary":"darkknightrises-tlr2 h1080p HD",
            "episode_identifier":"",
            "transcript":"",
            "organization_id":13,
            "duration_in_milliseconds":139223,
            "duration_in_seconds":139,
            "published_at":"2016-12-05T14:36:12.650-05:00",
            "submitted_at":"2016-12-05T14:36:12.650-05:00",
            "syndicated_at":null,
            "syndicated":false,
            "syndication_groups":[],
            "user_id":24,
            "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/framegrab/framegrab_3add329d-0710-4b36-8a34-922510e91bfb.jpg",
            "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_thumb_hd/vod_thumb_hd_89895332-0f21-4e87-9f0d-2774fc797ceb.jpg",
            "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_thumb_sd/vod_thumb_sd_f2b07f71-08ba-4876-b0df-821ebdf6f908.jpg",
            "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/thumb/thumb_9ce9a440-7a9a-43af-822c-f39eb52760c8.jpg",
            "sources":
              [
                {
                  "url":"https://connectabr-vh.akamaihd.net/i/vod/connect-test/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_solid/d2f70f6e-ceb3-4102-930c-c6184114520d_,2250,1000,300,.mp4.csmil/master.m3u8",
                  "type":"hls"
                },
                {
                  "url":"https://telvuepmd-a.akamaihd.net/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_solid/d2f70f6e-ceb3-4102-930c-c6184114520d_2250.mp4",
                  "type":"http"
                },
                {
                  "url":"rtmp://cp.edgefcs.net/ondemand/mp4:connect-vod/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_solid/d2f70f6e-ceb3-4102-930c-c6184114520d_2250.mp4",
                  "type":"rtmp"
                }
              ],
            "type":"media",
            "updated_at":"2016-12-05T15:27:05.551-05:00",
            "created_at":"2016-12-05T14:35:13.338-05:00",
            "chapters":[]
          }
      },
      {
        "id":37883,
        "playlist_id":837,
        "sequence_number":2,
        "window_start":null,
        "window_end":null,
        "playable":
          {
            "id":32263,
            "uuid":"4fd5ac55-fb35-4a24-b814-d3cdef28a92a",
            "title":"shop around the corner 5 min",
            "short_summary":"shop around the corner 5 min",
            "episode_identifier":"",
            "transcript":"",
            "organization_id":13,
            "duration_in_milliseconds":305877,
            "duration_in_seconds":306,
            "published_at":"2016-12-05T14:36:08.695-05:00",
            "submitted_at":"2016-12-05T14:36:08.695-05:00",
            "syndicated_at":null,
            "syndicated":false,
            "syndication_groups":[],
            "user_id":24,
            "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/framegrab/framegrab_f464fdb6-c5a3-47dc-b818-7ea129cb7f03.jpg",
            "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_thumb_hd/vod_thumb_hd_beade90f-b722-4abd-82bd-e909b2f821ea.jpg",
            "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_thumb_sd/vod_thumb_sd_05bc0340-59b1-4436-a31e-e3783f2365e5.jpg",
            "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/thumb/thumb_f810a9c0-e850-45f9-b6fd-36867b508c3b.jpg",
            "sources":
              [
                {
                  "url":"https://connectabr-vh.akamaihd.net/i/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_solid/77f1b43a-9f08-4f12-964c-fb6e073153a8_,2250,1000,300,.mp4.csmil/master.m3u8",
                  "type":"hls"
                },
                {
                  "url":"https://telvuepmd-a.akamaihd.net/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_solid/77f1b43a-9f08-4f12-964c-fb6e073153a8_2250.mp4",
                  "type":"http"
                },
                {
                  "url":"rtmp://cp.edgefcs.net/ondemand/mp4:connect-vod/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_solid/77f1b43a-9f08-4f12-964c-fb6e073153a8_2250.mp4",
                  "type":"rtmp"
                }
              ],
            "type":"media",
            "updated_at":"2016-12-05T15:27:05.583-05:00",
            "created_at":"2016-12-05T14:35:42.872-05:00",
            "chapters":[]
          }
       }
    ]
}

Example cURL GET Playlist Item Request:

curl -k --header "CONNECT-ACCESS-KEY: mykey" \
--header "CONNECT-SECRET-PASSPHRASE: mysecretpassphrase" \
https://connect.telvue.com/api/v2/playlists/837/playlist_items/37883.json

Example JSON Response:

{
  "playlist_item":
    {
      "id":37883,
      "playlist_id":837,
      "sequence_number":2,
      "window_start":null,
      "window_end":null,
      "playable":
        {
          "id":32263,
          "uuid":"4fd5ac55-fb35-4a24-b814-d3cdef28a92a",
          "title":"shop around the corner 5 min",
          "short_summary":"shop around the corner 5 min",
          "episode_identifier":"",
          "transcript":"",
          "organization_id":13,
          "duration_in_milliseconds":305877,
          "duration_in_seconds":306,
          "published_at":"2016-12-05T14:36:08.695-05:00",
          "submitted_at":"2016-12-05T14:36:08.695-05:00",
          "syndicated_at":null,
          "syndicated":false,
          "syndication_groups":[],
          "user_id":24,
          "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/framegrab/framegrab_f464fdb6-c5a3-47dc-b818-7ea129cb7f03.jpg",
          "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_thumb_hd/vod_thumb_hd_beade90f-b722-4abd-82bd-e909b2f821ea.jpg",
          "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_thumb_sd/vod_thumb_sd_05bc0340-59b1-4436-a31e-e3783f2365e5.jpg",
          "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/thumb/thumb_f810a9c0-e850-45f9-b6fd-36867b508c3b.jpg",
          "sources":
            [
              {
                "url":"https://connectabr-vh.akamaihd.net/i/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_solid/77f1b43a-9f08-4f12-964c-fb6e073153a8_,2250,1000,300,.mp4.csmil/master.m3u8",
                "type":"hls"
              },
              {
                "url":"https://telvuepmd-a.akamaihd.net/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_solid/77f1b43a-9f08-4f12-964c-fb6e073153a8_2250.mp4",
                "type":"http"
              },
              {
                "url":"rtmp://cp.edgefcs.net/ondemand/mp4:connect-vod/ae9b0680-0b93-0133-e301-52540084dd42/4fd5ac55-fb35-4a24-b814-d3cdef28a92a/vod_solid/77f1b43a-9f08-4f12-964c-fb6e073153a8_2250.mp4",
                "type":"rtmp"
              }
            ],
          "type":"media",
          "updated_at":"2016-12-05T15:27:05.583-05:00",
          "created_at":"2016-12-05T14:35:42.872-05:00",
          "chapters":[]
        }
    }
}

in Connect APIs

Related Articles