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:

  • Languages

This document describes the API for reading language.

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/languages.[xml|json]

Returns a list of all languages.

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 example returns a listing of all language.
[GET] https://service_name.synctv.com/api/v2/languages.xml?access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d
Request Field:
  • (String) code_like — Filters response to include items that contain the specified value in the code field (e.g. code_like=eng).
  • (Array) any_of_code — Filters response to include langauge that match any of the supplied code values (e.g. any_of_code[]=eng&any_of_code[]=fre).
  • (String) name_like — Filters response to include languages the english name of the language(e.g. name_like=French).
Example Response
XML JSON

<response>
  <languages>
    <language>
      <id>1</id>
      <code>eng</code>
      <name nil="true"/>
    </language>
    <language>
      <id>2</id>
      <code>eng</code>
      <name nil="true"/>
    </language>
  </languages>
</response>

Url:

  • [GET] /api/v2/languages/:id.[xml|json]

Returns information for the specified languages.

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 returns the language information for language 100. 
[GET] https://service_name.synctv.com/api/v2/languages/100.xml?access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d
Example Response
XML JSON

<response>
  <media_types>
    <id>100</id>
    <code>eng</code>
    <name nil="true"/>
  </media_types>
</response>
Response Fields:
  • (Integer) language[id]
    The unique identifier of the language.
  • (String) language[code]
    The code of the language.
  • (String) language[name]
    The english name of the language.

Url:

  • [GET] /api/v2/languages/count.[xml|json]

Returns count of all languages.

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 returns the language information for language 100. 
[GET] https://service_name.synctv.com/api/v2/languages/count.xml?access_id=1234&signature=674aaff974348eb1a1bdd72dce75053d
Example Response
XML JSON

<response>
  <count>30</count>
  <code>1</code>
  <message>Successfully completed.</message>
</response>
Response Fields:
  • (Integer) count
    The count of all languages