Zur Übersicht

URL-Synopsis

   http://api.golem.de/api/video/meta/video_identifier/?key=developerkey&format=resultformat
   http://api.golem.de/api/video/meta/video_identifier/?key=developerkey
  

Function

Returns the meta information for a video.

Arguments

Name Datatype Meaning Default value
video_identifier Integer The identifier of the video to retrieve the meta data for. Value required
developerkey String A valid developer key Value required
resultformat String The format of the result set (Allowed values: json or xml) json

Returns

The result data is encoded in UTF-8.

Name Datatype Meaning
success Boolean Indicates, wether the request could be successfully handle (true) or not (false).
data Array The meta information of the video, if the request was sucessful
errorCode Integer The error code, if the request was not successful
errorMessage String The error message, if the request was not successful

Data Array

The data represents the meta data of a video.

Name Datatype Meaning
videoid Integer The identifier of the video
embeddedcode String The HTML code to embedded the video player and the video into a HTML page.
pageurl String The URL of video specific page on Golem.de.
title String The title of the video
playtime Float The duration of the video in seconds.
medium Array The data for the video in regular quality. This is the default format for every Golem.de video.
    videourl String The URL of the video file.
    width Integer The video width in pixel.
    height Integer The video height in pixel.
    size Integer The filesize of the video in bytes.
    mimetype String The mimetype of the video file.
    image Array The teaser image of the video, array keys are:
  • height (Integer) - The image height
  • width (Integer) - The image width
  • url (String) - The image url
high Array The data for the video in high quality. Optional.
    videourl String The URL of the video file.
    width Integer The video width in pixel.
    height Integer The video height in pixel.
    size Integer The filesize of the video in bytes.
    mimetype String The mimetype of the video file.
    image Array The teaser image of the video, array keys are:
  • height (Integer) - The image height
  • width (Integer) - The image width
  • url (String) - The image url
apple Array The data for the video encoded to be viewable on special devices. Optional
    videourl String The URL of the video file.
    width Integer The video width in pixel.
    height Integer The video height in pixel.
    size Integer The filesize of the video in bytes.
    mimetype String The mimetype of the video file.
    image Array The teaser image of the video, array keys are:
  • height (Integer) - The image height
  • width (Integer) - The image width
  • url (String) - The image url

Error codes

Code Meaning
1 Internal Data access error
32 Video identifier is missing, invalid or video is not available

Test output with as JSON

{"__className":"stdClass","data":{"videoid":1,"embeddedcode":"<object width=\
"480\" height=\"270\"><param name=\"movie\" value=\"http://video.golem.de/
player/videoplayer.swf?id=123456&autoPl=false\"></param><param name=
\"allowFullScreen\" value=\"true\"></param><param name=\"AllowScript
Access\" value=\"always\"><embed src=\"http://video.golem.de/player/videop
layer.swf?id=123456&autoPl=false\"type=\"application/x-shockwave-flash\" allowfu
llscreen=\"true\" AllowScriptAccess=\"always\" width=\"480\" height=\"270\"><
/embed> </object><div style=\"width:480px; text-align:center; font-f
amily:verdana,sans-serif; font-size:0.8em;\"><a href=\"http://video.golem.
de/\">Video: Beispielvideo</a> (0:0)</div>","pageurl":"http:
//video.golem.de/","title":"Lorem ipsum dolor sit amet consectetuer sadipscing e
litr sed","playtime":"6.00","medium":{"videourl":"http://api.golem.de/video/Gole
mvideo_medium.flv","width":480,"height":270,"size":210055,"mimetype":"video/x-fl
v","image":{"height":270,"width":480,"url":"http://api.golem.de/video/teaser_vid
eo.png"}},"high":{"videourl":"http://api.golem.de/video/Golemvideo_HD.mp4","widt
h":960,"height":540,"size":715044,"mimetype":"video/quicktime","image":{"height"
:270,"width":480,"url":"http://api.golem.de/video/teaser_video.png"}},"apple":{"
videourl":"http://api.golem.de/video/Golemvideo_iPod.m4v","width":640,"height":3
60,"size":220576,"mimetype":"video/quicktime","image":{"height":270,"width":480,
"url":"http://api.golem.de/video/teaser_video.png"}}},"success":true}
  

Test output with as XML

<?xml version="1.0" encoding="UTF-8"?>
<golemderesult>
<success>1</success>
<data>
<videoid>1</videoid>
<embeddedcode>&lt;object width=&quot;480&quot; height=&quot;270&quot;&gt;&lt;param name=&quot;movie&quot; value=&quot;http://video.golem.de/player/videoplayer.swf?id=123456&amp;autoPl=false&quot;&gt;&lt;/param&gt;&lt;param name=&quot;allowFullScreen&quot; value=&quot;true&quot;&gt;&lt;/param&gt;&lt;param name=&quot;AllowScriptAccess&quot; value=&quot;always&quot;&gt;&lt;embed src=&quot;http://video.golem.de/player/videoplayer.swf?id=123456&amp;autoPl=false&quot;type=&quot;application/x-shockwave-flash&quot; allowfullscreen=&quot;true&quot; AllowScriptAccess=&quot;always&quot; width=&quot;480&quot; height=&quot;270&quot;&gt;&lt;/embed&gt; &lt;/object&gt;&lt;div style=&quot;width:480px; text-align:center; font-family:verdana,sans-serif; font-size:0.8em;&quot;&gt;&lt;a href=&quot;http://video.golem.de/&quot;&gt;Video: Beispielvideo&lt;/a&gt;&amp;nbsp;(0:0)&lt;/div&gt;</embeddedcode>

<pageurl>http://video.golem.de/</pageurl>
<title>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</title>
<playtime>6.00</playtime>
<medium>
<videourl>http://api.golem.de/video/Golemvideo_medium.flv</videourl>
<width>480</width>
<height>270</height>
<size>210055</size>
<mimetype>video/x-flv</mimetype>

<image>
<height>270</height>
<width>480</width>
<url>http://api.golem.de/video/teaser_video.png</url>
</image>
</medium>
<high>
<videourl>http://api.golem.de/video/Golemvideo_HD.mp4</videourl>
<width>960</width>
<height>540</height>
<size>715044</size>

<mimetype>video/quicktime</mimetype>
<image>
<height>270</height>
<width>480</width>
<url>http://api.golem.de/video/teaser_video.png</url>
</image>
</high>
<apple>
<videourl>http://api.golem.de/video/Golemvideo_iPod.m4v</videourl>
<width>640</width>
<height>360</height>

<size>220576</size>
<mimetype>video/quicktime</mimetype>
<image>
<height>270</height>
<width>480</width>
<url>http://api.golem.de/video/teaser_video.png</url>
</image>
</apple>
</data>
</golemderesult>
  


Zur Übersicht