HomeAboutUpload a mediafile.

Upload a mediafile.

17May2010 Posted by admin

Upload a mediafile.

Request URL

/mediafile/upload [POST]

Request Authorization

This call can be called without any authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
upload_ticket (TICKET_ID)The ID that has been given to enable the upload.Required-
app_id[] (APP_ID)The application ID.Optional0-
completed_transcoding_url (URL)This URL is called after the status of transcoding job changed.Optional-
completed_url (URL)This URL gives opportunity to the APP builder for a status raport; upload_ticket status_code The upload_ticket is used to identify the upload. The status_code is a Mediamosa code. The type is URL and not URI, because this parameter http:// or https://.Optional-
create_still (BOOL)Specify 'true', if you want a still is generated after the upload and analysis See: Still creation parameters (POST) on /mediafile/{mediafile_id}/still/create [POST].OptionalFALSE-
default (BOOL)Is default still? Only used when still_upload = true.OptionalFALSE-
end_frame (INT)Still end frame.Optional-
filename (STRING)The filename of the media file (PUT method only, ignored otherwise).Optional-
frametime (INT)Still frametime.Optional-
h_padding (INT)Still horizontal padding.Optional-
height (INT)Still height.Optional-
order (INT)Still order number. Only used when still_upload = true.Optional0-
redirect_uri (URL)The URL to redirect when upload has been successful.Optional-
retranscode (BOOL)if 'retranscode' is not put, all existing transcodes of the original media file will be lost. If 'retranscode' is 'true', then new transcode jobs will be created, which replace the existing transcodes..OptionalFALSE-
size (STRING)Size of the still.Optional-
start_frame (INT)Still start frame.Optional-
still_every_second (INT)Stills every second.Optional-
still_per_mediafile (INT)Stills per mediafile.Optional-
still_type (STRING)The still type.
Value (when supplied) must be either "NONE" or "PICTURE" or "SCENE" or "SECOND" or "NORMAL".		Optional-
still_upload (BOOL)Specify TRUE for adding a still to the mediafile.OptionalFALSE-
tag (STRING)Still tag.Optional-
transcode[] (INT)If one (or more) transcode profiles is in this parameter than the media file will be transcoded after the upload.Optional-
transcode_inherits_acl (BOOL)If 'true'; All the acl media rights will be copied to the new transcoded media file.OptionalFALSE-
v_padding (INT)Still vertical padding.Optional-
width (INT)Still width.Optional-

Example Request

[POST] mediafile/upload

Example Response