oEmbed get.

22Aug2011 Posted by admin

oEmbed is a format for allowing an embedded representation of a URL on third party sites.

Request URL

/services/oembed [GET]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)	Description	Required	Default value	Max. length
app_id[] (APP_ID)	The application ID.	Optional	0	-
format (RESPONSE_TYPE)	The required response format. Value (when supplied) must be either "xml" or "json".	Optional	json	-
maxheight (INT)	The maximum height of the embedded resource.	Optional		-
maxwidth (INT)	The maximum width of the embedded resource.	Optional		-
mediafile_id (ALPHA_NUM)	The ID of the mediafile to retrieve.	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		-
provider_name (STRING)	Name of the provider.	Optional		-
provider_url (STRING)	URL of the provider.	Optional		-
still_id (ALPHA_NUM)	Default this specific still.	Optional		-

Example Request

services/oembed?mediafile_id=6334&format=json

Example Response

{
  "version": "1.0",
  "type": "video",
  "width": 240,
  "height": 160,
  "title": "Big house",
  "author_name": "BigR",
  "author_url": "http://bigr.mediamosa.org/",
  "provider_name": "MediaMosa",
  "provider_url": "http://mediamosa.org/",
  "html": "<object width=\"320\" height=\"240\" data=\"http://drebbel.mediamosa.org/flowplayer/flowplayer-3.1.5.swf\" type=\"application/x-shockwave-flash\">
  <param name=\"movie\" value=\"http://drebbel.mediamosa.org/flowplayer/flowplayer-3.1.5.swf\" />
  <param name=\"allowfullscreen\" value=\"true\" />
  <param name=\"allowscriptaccess\" value=\"always\" />
  <param name=\"flashvars\" value='config={\"plugins\":{\"pseudo\":{\"url\":\"flowplayer.pseudostreaming-3.1.3.swf\"},\"controls\":{\"backgroundColor\":\"#000000\",\"backgroundGradient\":\"low\"}},\"clip\":{\"provider\":\"pseudo\",\"url\":\"http://mediamosa.local/ticket/14/nbSFPcFPVsbYEaEK755FwfLn.flv\", \"autoPlay\":false},\"playlist\":[{\"provider\":\"pseudo\",\"url\":\"http://mediamosa.local/ticket/14/nbSFPcFPVsbYEaEK755FwfLn.flv\"}]}' />
</object>",
}