= REST interface introduction =

== REST calls as a MediaMosa communication interface ==
 * REST = Representational State Transfer
 * GET calls for getting data
 * POST calls for changing or creating data
 * Output is XML
 * Documentation of REST calls:[[BR]]
   http://mediamosa.org/api [[BR]]
   You can see here parameters, response fields, examples.

== REST calls as a MediaMosa communication interface ==

Example: /mediafile/$mediafile_id [GET]

{{{
<items>
  <item id="1">
    <mediafile_id>6778</mediafile_id>
    <asset_id>7AkD</asset_id>
    <app_id>14</app_id>
    <owner_id>admin</owner_id>
    <group_id></group_id>
    ....
  </item>
</items>
}}}

== An example: How you can upload a video file? ==

Your client application:

 * Create asset[[BR]]
   * /asset/create [POST][[BR]]
   * Response: $asset_id

 * Create mediafile[[BR]]
   * /mediafile/create [POST]
   * POST parameter: $asset_id[[BR]]
   * Response: $mediafile_id

 * Create upload ticket[[BR]]
   * /mediafile/$mediafile_id/uploadticket/create [POST][[BR]]
   * Response: Action URL, Upload progress URL (for upload progress bar)

 * Use the Action URL as a target of your form with the file field