Client APIs
At its core, SyncTV is an API driven service. The APIs themselves are easy enough for developers to understand, but understanding the ecosystem is a little trickier. We've created the following tutorials to help you get your head around it.

Topics:

  • Smooth manifests

This document describes the API for smooth_manifests.

Note:
Each call to the SyncTV V2 API described in this section requires an MD5 hash signature.
See the Authorization (User) API for details on generating the MD5 hash signature.
Actions

Url:

  • [GET] /api/v2/media/:medium_id/smooth_manifests.[xml|json]

Returns a list of media smooth_manifests scoped to the user's current platform.

Required Arguments:
  • (Integer) access_id
    Access id returned from Authorization (User) client_authorize.
  • (String) signature
    MD5 hash encoded string of alphabetically sorted query parameters.
Example Request

The following example returns all smooth_manifests for media 100.
[GET] https://service_name.synctv.com/api/v2/media/100/smooth_manifests.xml?ownership_id=1&access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d
Request Field:
  • (Integer) offset — Used for pagination of response data (default: 25 items per response). Specifies the offset of the next block of data to receive.
  • (Integer) ownership_id — The ID of the Ownership that is being used to validate access to the smooth_manifests. (Note: required if media belongs to a bundle)
Example Response
XML JSON

<response>
  <smooth_manifests>
    <smooth_manifest>
      <id>1</id>
      <ingest_id>1</ingest_id>
      <file_size nil="true"/>
      <file_path>filepath/manifest/smooth/file_6.ismc</file_path>
      <protected>false</protected>
      <file_url>http://smooth.mytf1vod.fr/ondemand/filepath/manifest/smooth/file_6.ismc</file_url>
      <asset_size>0</asset_size>
      <av_format_set_id nil="true"/>
      <iteration>0</iteration>
      <remove_on nil="true"/>
      <marked_for_deletion>false</marked_for_deletion>
      <hd>false</hd>
      <resolution>sd</resolution>
      <license_challenge nil="true"/>
      <license_server_url nil="true"/>
      <audio_language nil="true"/>
    </smooth_manifest>
    <smooth_manifest>
      <id>2</id>
      <ingest_id>2</ingest_id>
      <file_size nil="true"/>
      <file_path>filepath/manifest/smooth/file_7.ismc</file_path>
      <protected>false</protected>
      <file_url>http://smooth.mytf1vod.fr/ondemand/filepath/manifest/smooth/file_7.ismc</file_url>
      <asset_size>0</asset_size>
      <av_format_set_id nil="true"/>
      <iteration>0</iteration>
      <remove_on nil="true"/>
      <marked_for_deletion>false</marked_for_deletion>
      <hd>false</hd>
      <resolution>sd</resolution>
      <license_challenge nil="true"/>
      <license_server_url nil="true"/>
      <audio_language nil="true"/>
    </smooth_manifest>
  </smooth_manifests>
</response>
Response Fields:
  • (Response) smooth_manifests
    A list of smooth_manifest items for the specified media.