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:
  http://mediamosa.org/api
  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
  
  • /asset/create [POST]
    
  • Response: $asset_id

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

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

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