Get a profile.

17May2010

Get a profile.

Request URL

/transcode/profile/$profile_id [GET]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
profile_id (INT)The ID of the profile to retrieve.Required-

Example Request

transcode/profile/1

Example Response

<items>
  <item id="1">
    <nid>1</nid>
    <vid>42</vid>
    <transcode_profile_id>1</transcode_profile_id>
    <app_id>0</app_id>
    <version>0</version>
    <profile>standaard flash</profile>
    <is_default_profile>FALSE</is_default_profile>
    <tool>ffmpeg</tool>
    <file_extension>flv</file_extension>
    <command>videobitrate:500000;fps:25;size:320x200;videocodec:flv;audiocodec:libmp3lame;audiobitrate:64000;audiosamplingrate:22050;audiochannels:1;maintain_aspect_ratio:yes;padding:no</command>
    <created>2010-04-07 13:37:31</created>
    <changed>2010-04-07 13:37:31</changed>
  </item>
</items>

Comments

nid and vid ?

What are the <nid> and <vid> parameters used for?

nid is the node ID of the

nid is the node ID of the profile. Its not used directly by MediaMosa (it still uses the transcode_profile_id). The node ID is new in 2.0 and is used by Drupal, which connects a node to it, resulting in a node ID. Because node IDs are given to every type of object within Drupal; therefor the transcode_profile_id could not automaticly be the node ID as well. You can see the node ID as a global ID within the Drupal database. In the future we can go much further with this by giving all objects, including assets, mediafiles, a node ID. Then any object in the database will have a unique numeric node ID. In future we will be able to search through all objects, all data, any type.

vid is also a unique ID, but for the version. You can have multiple versions of the Profile, where the vid is the version ID. 'vid' is also unique over the whole database. Meaning, that if you only have the vid ID and not the node ID, you can still retrieve the right object. Only supplying the node ID will result in the latest 'version' of the object.

MediaMosa 2.0 uses the nid and vid for version control and for future expansion for database. Its not used (yet) in any REST call and is returned already for future usage.