HomeAboutmediafile/create

mediafile/create

29Sep2009 Posted by forgacs

Making mediafile

This call makes an empty mediafile to use it later for file-upload or for saving an external stream url.

If a mediafiles was made with the parameter 'uri', you can't use that to upload a file. Otherwise if you use the parameter 'filename', you can use an URL parameter any more.

Request URL

mediafile/create [POST]

Request parameters

Parameter

Type

Description

Method

Obligatory/Optional

asset_id

alphanumeric

the asset id for linking the mediafile

POST

obligatory

user_id

string

this parameter will be the user in the database

POST

obligatory

group_id

alphanumeric

this parameter will be the group in the database

POST

optional

uri

string

the URL of an external stream

POST

optional

is_downloadable

'true' or 'false'

or the mediafile will be downloadable

POST

optional (should not be used in conjunction with uri) default = false.

 

Example request URL

/mediafile/create?
POST:

asset_id=jeJbje9ujwer3

user_id=username

group_id=groupname
uri=rtsp://server.ext/stream

Example response

 <items>
   <item id="1">
    <mediafile_id>MeOxhYLHq97Db71EdxSBcehuhb</mediafile_id>
  </item>
</items>

Response fields

Field

Description

mediafile_id

the reserved mediafile_id