Upload a mediafile.
20Oct2010
Posted by admin
Upload a mediafile.
Request URL
/mediafile/upload [PUT]
Request Authorization
This call needs EGA authentication.
Request Parameters
| Parameter (Type) | Description | Required | Default value | Max. length |
|---|---|---|---|---|
| filename (STRING) | The filename of the media file (PUT method only, ignored otherwise). | Required | - | |
| upload_ticket (TICKET_ID) | The ID that has been given to enable the upload. | Required | - | |
| user_id (ALPHA_NUM) | User id, determined to check whether the applicant has the rights and quotas to upload the mediafile. | Required | - | |
| app_id[] (APP_ID) | The application ID. | Optional | 0 | - |
| 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]. | Optional | FALSE | - |
| default (BOOL) | Is default still? Only used when still_upload = true. | Optional | FALSE | - |
| end_frame (INT) | Still end frame. (in seconds, used when still_type is NORMAL or SECOND). | 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. | Optional | 0 | - |
| 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.. | Optional | FALSE | - |
| size (STRING) | Size of the still. | Optional | 352x288 | - |
| start_frame (INT) | Still start frame. (in seconds, used when still_type is NORMAL or SECOND). | Optional | - | |
| still_every_second (INT) | Stills every second (Used when still_type is SECOND). | Optional | - | |
| still_per_mediafile (INT) | Stills per mediafile (Used when still_type is NONE). | Optional | - | |
| still_type (STRING) | The still type. Value (when supplied) must be either "NONE" or "SCENE" or "SECOND" or "NORMAL" or "". | Optional | NONE | - |
| still_upload (BOOL) | Specify TRUE for adding a still to the mediafile. | Optional | FALSE | - |
| tag (STRING) | Mediafile tag to set. An empty tag will clear possible set mediafile 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. | Optional | FALSE | - |
| v_padding (INT) | Still vertical padding. | Optional | - | |
| width (INT) | Still width. | Optional | - |
Example Request
[PUT] mediafile/upload
Example Response
- Login or register to post comments
- Printer-friendly version
- Send by email
MediaMosa API
Search Mediamosa 2.2
  |
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License |  |
Developer links
The current recommended MediaMosa version is 3.2.2. Release notes are available in MediaMosa Trac.