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.
https://connect.telvue.com/api/v2/media
https://connect.telvue.com/api/v2/media/:id
Using your favorite HTTP tool or library, make a GET request to https://connect.telvue.com/api/v2/media/:id replace :id with the id of the Connect Medium being requested and include Access Key and Secret Passphrase for the Client Application from which you are making the request.
The popular cURL tool comes bundled with any Linux, Mac, or UNIX operating system, and there are Windows equivalents.
Example cURL GET Medium Index Request:
curl -k --header "CONNECT-ACCESS-KEY: mykey" --header "CONNECT-SECRET-PASSPHRASE: mysecretpassphrase" https://connect.telvue.com/api/v2/media.json
Example JSON Response:
{ "media": [ { "id":32261, "uuid":"b378d7f2-eee9-42fb-9948-5ddffe5900a9", "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-05T13:35:56.548-05:00", "submitted_at":"2016-12-05T13:35:56.548-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/b378d7f2-eee9-42fb-9948-5ddffe5900a9/framegrab/framegrab_ad41f656-0589-4561-be22-40979c434a35.jpg", "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_thumb_hd/vod_thumb_hd_cb2da58a-528d-441f-baf4-d3c56d4bbe35.jpg", "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_thumb_sd/vod_thumb_sd_f59eb68f-28c5-475d-94a8-928465a73e6c.jpg", "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/thumb/thumb_520faac4-087c-44e8-98e9-89062208caf0.jpg", "sources": [ { "url":"https://connectabr-vh.akamaihd.net/i/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_solid/3eaffcce-cf39-4b40-a44f-45fe8f3efc40_,2250,1000,300,.mp4.csmil/master.m3u8", "type":"hls" }, { "url":"https://telvuepmd-a.akamaihd.net/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_solid/3eaffcce-cf39-4b40-a44f-45fe8f3efc40_2250.mp4", "type":"http" }, { "url":"rtmp://cp.edgefcs.net/ondemand/mp4:connect-vod/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_solid/3eaffcce-cf39-4b40-a44f-45fe8f3efc40_2250.mp4", "type":"rtmp" } ], "type":"media", "updated_at":"2016-12-05T13:44:36.149-05:00", "created_at":"2016-12-05T13:34:19.443-05:00", "chapters": [ { "id":34236, "title":"Chapter 1", "start_time":60.0, "end_time":90.0, "short_summary":"", "description":"Chapter 1: Bane Appears", "thumbnail_url":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/preview_59d0e57f-3cbf-43f5-a952-65ed836c0537.jpg", "index":1, "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/preview_59d0e57f-3cbf-43f5-a952-65ed836c0537.jpg", "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/vod_thumb_hd/vod_thumb_hd_e29cdb9a-76e1-4a1f-a05f-ed68b71b3297.jpg", "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/vod_thumb_sd/vod_thumb_sd_386c4be3-dfd5-401b-a6a2-f3869f343b90.jpg", "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/thumb/thumb_2560f9ed-81cd-4621-8fe3-e07b9ebc6477.jpg" } ] } ] }
Example cURL GET Medium Request:
curl -k --header "CONNECT-ACCESS-KEY: mykey" --header "CONNECT-SECRET-PASSPHRASE: mysecretpassphrase" --header "Content-Type: application/json" https://connect.telvue.com/api/v2/media/32261.json
{ "medium": { "id":32261, "uuid":"b378d7f2-eee9-42fb-9948-5ddffe5900a9", "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-05T13:35:56.548-05:00", "submitted_at":"2016-12-05T13:35:56.548-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/b378d7f2-eee9-42fb-9948-5ddffe5900a9/framegrab/framegrab_ad41f656-0589-4561-be22-40979c434a35.jpg", "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_thumb_hd/vod_thumb_hd_cb2da58a-528d-441f-baf4-d3c56d4bbe35.jpg", "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_thumb_sd/vod_thumb_sd_f59eb68f-28c5-475d-94a8-928465a73e6c.jpg", "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/thumb/thumb_520faac4-087c-44e8-98e9-89062208caf0.jpg", "sources": [ { "url":"https://connectabr-vh.akamaihd.net/i/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_solid/3eaffcce-cf39-4b40-a44f-45fe8f3efc40_,2250,1000,300,.mp4.csmil/master.m3u8", "type":"hls" }, { "url":"https://telvuepmd-a.akamaihd.net/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_solid/3eaffcce-cf39-4b40-a44f-45fe8f3efc40_2250.mp4", "type":"http" }, { "url":"rtmp://cp.edgefcs.net/ondemand/mp4:connect-vod/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/vod_solid/3eaffcce-cf39-4b40-a44f-45fe8f3efc40_2250.mp4", "type":"rtmp" } ], "type":"media", "updated_at":"2016-12-05T13:44:36.149-05:00", "created_at":"2016-12-05T13:34:19.443-05:00", "chapters": [ { "id":34236, "title":"Chapter 1", "start_time":60.0, "end_time":90.0, "short_summary":"", "description":"Chapter 1: Bane Appears", "thumbnail_url":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/preview_59d0e57f-3cbf-43f5-a952-65ed836c0537.jpg", "index":1, "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/preview_59d0e57f-3cbf-43f5-a952-65ed836c0537.jpg", "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/vod_thumb_hd/vod_thumb_hd_e29cdb9a-76e1-4a1f-a05f-ed68b71b3297.jpg", "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/vod_thumb_sd/vod_thumb_sd_386c4be3-dfd5-401b-a6a2-f3869f343b90.jpg", "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/b378d7f2-eee9-42fb-9948-5ddffe5900a9/chapters/34236/thumb/thumb_2560f9ed-81cd-4621-8fe3-e07b9ebc6477.jpg" } ] } }