Admin 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:

  • Account info

This document describes the API for reading the current account's media ownerships info.

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/:id/info.[xml|json]

DEPRECATED: This API is deprecated and may be removed from future releases, use a combination of add_fields filter and the batch API call.

Returns the currently authorized account's ownership information for the specified media.

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

The following URL requests account specific ownership information for media id = 1
[GET] https://service_name.synctv.com/api/v2/media/1/info.xml?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.
  • (Array) ownership[status] — Filter ownerships by status, same way as the ownerships API (E.G. ownership[status][]=-1&ownership[status][]=1).
Example Response
XML JSON

<response>
  <ownership_policies>
    <ownership_policy>
      <id>1</id>
      <name>MyString</name>
      <status>0</status>
      <keys>
        <key>OWNERSHIP_STATUS_AND_START_END_DATE</key>
      </keys>
      <price>
        <amount>15.1</amount>
        <currency>USD</currency>
        <tax>0.00</tax>
      </price>
    </ownership_policy>
  </ownership_policies>
  <watched_time>1000</watched_time>
  <account_media_link_id>1</account_media_link_id>
  <account_rating>5</account_rating>   
  <ownerships>
    <ownership>
      <id>9</id>
      <media_id>22</media_id>
      <ownership_policy_id>1</ownership_policy_id>
      <account_id>13</account_id>
      <status>0</status>
      <begin_at>2012-02-24T10:04:18Z</begin_at>
      <end_at>2012-02-24T10:04:18Z</end_at>
    </ownership>
    <ownership>
      <id>10</id>
      <media_id>23</media_id>
      <ownership_policy_id>1</ownership_policy_id>
      <account_id>14</account_id>
      <status>0</status>
      <begin_at>2012-02-24T10:04:18Z</begin_at>
      <end_at>2012-02-24T10:04:18Z</end_at>
    </ownership>
  </ownerships>
  <code>1</code>
  <messages>
    <message>Successfully completed.</message>
  </messages>
</response>