HomeAboutUpload still image.

Upload still image.

22Aug2011 Posted by admin

Still images can be uploaded to existing mediafiles.

Request URL

/asset/$asset_id/still/upload [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
asset_id (ALPHA_NUM)The asset ID.Required-
mediafile_id (ALPHA_NUM)The mediafile ID.Required-
upload_ticket (TICKET_ID)The ID that has been given to enable the upload.Required-
app_id[] (APP_ID)The application ID.Optional0-
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-
default (BOOL)Is default still?OptionalFALSE-
filename (STRING)The filename of the media file (PUT method only, ignored otherwise).Optional-
mediamosa_version (MEDIAMOSA_VERSION)Provide the version to get the REST call returned in the format of the specified MediaMosa version. Keep empty or skip to retrieve in current (latest) version. Provide '2' to retrieve the REST call in 2.x format. Or be more specific by providing up to 3 digits; '2.3.0'. This setting will override any setting used by client application or the default setting in MediaMosa.Optional-
order (INT)Still order number.Optional0-
redirect_uri (URL)The URL to redirect when upload has been successful.Optional-
tag (STRING)Still tag.Optional-
watermark_dst_x (INT)X-coordinate of destination point of watermark.Optional0-
watermark_dst_y (INT)Y-coordinate of destination point of watermark.Optional0-
watermark_h_align (STRING)Horizontal align of watermark.
Value (when supplied) must be either "top" or "bottom".		Optionaltop-
watermark_id (ALPHA_NUM)The watermark ID.Optional-
watermark_pct (INT)Alpha transparency of watermark (watermark visibility in percentage [0 - 100%]).Optional75-
watermark_v_align (STRING)Vertical align of watermark.
Value (when supplied) must be either "left" or "right".		Optionalleft-

Example Request

/asset/B93Y4bJxLRof608OtHofiK9C/still/upload

mediafile_id = "2rw3r5235gdg"
"upload_ticket = "j89y492b84"
order = 2
default = "TRUE"

Example Response

<items>
  <item>
    <still_id>f608OtH9CB9R3Y4ofiKbJxLo</still_id>
  </item>
</items>