HomeAboutOpenSocial upload.

OpenSocial upload.

22Aug2011 Posted by admin

Content Upload is a generic mechanism to allow for a standard way to upload content.

Request URL

/openapi/album/$album_id [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
Request-Parameter-Format-Value (RESPONSE_TYPE)The response type paramter.
Value (when supplied) must be either "xml" or "atom" or "rss" or "json".		Optional-
Request-Parameter-Formet-Value (RESPONSE_TYPE)The response type paramter.
Value (when supplied) must be either "xml" or "atom" or "rss" or "json".		Optional-
Request-Parameter-UpdatedSince-Value (DATETIME_UTC)Only return items whose updated date & time is equal to or more recent then the specified value (e.g. 2008-01-23T04:56:22Z).Optional-
album_id (ALPHA_NUM)Album to which the media item belongs. Optional-
app_id[] (APP_ID)The application ID.Optional0-
created (DATETIME_UTC)Creation datetime associated with the media item - assigned by container in UTC (e.g. 2008-01-23T04:56:22Z).Optional-
description (STRING)Description of the media item.Optional-
duration (INT)For audio/video clips - playtime length in seconds. set to -1/not defined if unknown.Optional-1-
file_size (INT)Number of bytes (set to -1/undefined if unknown).Optional-1-
id (ALPHA_NUM)Id Associated with the media item.Optional-
language (LANGUAGE_CODE_ISO_639_3)Language associated with the media item in ISO 639-3 format.Optional-
last_updated (DATETIME_UTC)Update datetime associated with the media item - assigned by container in UTC (e.g. 2008-01-23T04:56:22Z).Optional-
location (STRING)Location corresponding to the media item.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-
mime_type (MIMETYPE)The MIME type of media, specified as a string.Optional-
num_comments (UINT)Number of comments on the media item.Optional-
num_views (UINT)Number of views for the media item.Optional-
num_votes (UINT)Number of votes received for voting.Optional-
rating (UINT)Average rating of the media item on a scale of 0-10.Optional-
start_time (DATETIME_UTC)For streaming/live content, datetime when the content is available (e.g. 2008-01-23T04:56:22Z).Optional-
still_url (STRING)URL to a still image of the media item.Optional-
tagged_people[] (ALPHA_NUM)Array of string (IDs) of people tagged in the media item.Optional-
tags[] (STRING)Tags associated with this media item.Optional-
title (STRING)Describing the media item.Optional-
type (ALPHA)The type of media, specified as a MediaItem.Type object.
Value (when supplied) must be either "video".		Optional-
url (STRING)Specifying the URL where the media can be found.Optional-
user_id (ALPHA_NUM)User id.Optional-

Example Request

/album/112233

Example Response

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <author>
    <name>MediaMosa</name>
  </author>
  <link href="http://mediamosa.org/"/>
  <entry xmlns="http://www.w3.org/2005/Atom" xmlns:osapi="http://opensocial.org/2008/opensocialapi">
    <content type="application/xml">
      <mediaitem xmlns="http://ns.opensocial.org/2008/opensocial">
        <id>223344</id>
        <media_type>VIDEO</media_type>
      </mediaitem>
    </content>
    <title />
    <updated>2008-10-24T20:30:40.500Z</updated>
    <author />
  </entry>
</feed>