APIMethods/1.2.1/media.get – hyves_api

Context Navigation

media.get

Retrieves a list of media by mediaid.

Last update: Apr 17, 2008
Not <a href='http://hyves-developers.nl/documentation/data-api/pagination'>Paginated</a>

params

<a href='http://hyves-developers.nl/returnvalues#mediaid'>mediaid</a> --- Comma-separated list of mediaids.
- Required

responsefields

This method supports the use of <a href='http://hyves-developers.nl/documentation/data-api/global-ha-parameters'>ha_responsefields</a>. Acceptable values are a comma separated list of 0 or more of the following:

<a href='http://hyves-developers.nl/returnvalues##commentscount'>commentscount</a>
<a href='http://hyves-developers.nl/returnvalues##respectscount'>respectscount</a>
<a href='http://hyves-developers.nl/returnvalues##tags'>tags</a>
<a href='http://hyves-developers.nl/returnvalues##fancylayouttag'>fancylayouttag</a>
<a href='http://hyves-developers.nl/returnvalues##geolocation'>geolocation</a>
<a href='http://hyves-developers.nl/returnvalues##viewscount'>viewscount</a>
<a href='http://hyves-developers.nl/returnvalues##mobileurl'>mobileurl</a>

extra

Note that retrieving something by id always succeeds (as long as the id is valid), even if the visibility settings of the object do not allow viewing it. If some user is not allowed to view something, he/she will not get the id from another call.

examples

example 1

url

http://data.hyves-api.nl/?mediaid=1ab985e62ce920c2%2C979c94838207858d&ha_method=media.get&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117694&oauth_nonce=98416_523&ha_version=1.2.1&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=%2FO0lF893ydbiGd5OoRaeyEinAM8%3D

result

<?xml version="1.0" encoding="UTF-8"?>
<media_get_result>
        <media>
                <mediaid>1ab985e62ce920c2</mediaid>
                <userid>27b723a63cfccb23</userid>
                <title>Homo</title>
                <description/>
                <mediatype>image</mediatype>
                <icon_small>
                        <width>44</width>
                        <height>50</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_1_iQnC.jpeg</src>
                </icon_small>
                <icon_medium>
                        <width>66</width>
                        <height>75</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_2_iQnC.jpeg</src>
                </icon_medium>
                <icon_large>
                        <width>106</width>
                        <height>120</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_3_iQnC.jpeg</src>
                </icon_large>
                <icon_extralarge>
                        <width>176</width>
                        <height>200</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_4_iQnC.jpeg</src>
                </icon_extralarge>
                <image>
                        <width>300</width>
                        <height>339</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_5_iQnC.jpeg</src>
                </image>
                <image_fullscreen>
                        <width>300</width>
                        <height>339</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_6_iQnC.jpeg</src>
                </image_fullscreen>
                <square_large>
                        <width>75</width>
                        <height>75</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_14_iQnC.jpeg</src>
                </square_large>
                <square_extralarge>
                        <width>120</width>
                        <height>120</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_16_iQnC.jpeg</src>
                </square_extralarge>
                <url>http://homoapi.hyves.nl/fotos/205178878/0/iQnC/</url>
                <created>1205493772</created>
        </media>
        <media>
                <mediaid>979c94838207858d</mediaid>
                <userid>ea5c247f9d076822</userid>
                <title>Gorilla</title>
                <description/>
                <mediatype>image</mediatype>
                <icon_small>
                        <width>46</width>
                        <height>50</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_1_R4lg.jpeg</src>
                </icon_small>
                <icon_medium>
                        <width>69</width>
                        <height>75</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_2_R4lg.jpeg</src>
                </icon_medium>
                <icon_large>
                        <width>110</width>
                        <height>119</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_3_R4lg.jpeg</src>
                </icon_large>
                <icon_extralarge>
                        <width>184</width>
                        <height>200</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_4_R4lg.jpeg</src>
                </icon_extralarge>
                <image>
                        <width>400</width>
                        <height>433</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_5_R4lg.jpeg</src>
                </image>
                <image_fullscreen>
                        <width>400</width>
                        <height>433</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_6_R4lg.jpeg</src>
                </image_fullscreen>
                <square_large>
                        <width>75</width>
                        <height>75</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_14_R4lg.jpeg</src>
                </square_large>
                <square_extralarge>
                        <width>120</width>
                        <height>120</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_16_R4lg.jpeg</src>
                </square_extralarge>
                <url>http://gorillaapi.hyves.nl/fotos/205166437/0/R4lg/</url>
                <created>1205492027</created>
        </media>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>131</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</media_get_result>

example 2

url

http://data.hyves-api.nl/?mediaid=1ab985e62ce920c2%2C979c94838207858d&ha_method=media.get&ha_responsefields=commentscount%2Crespectscount%2Ctags%2Cfancylayouttag%2Cgeolocation%2Cviewscount%2Cmobileurl&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117694&oauth_nonce=153643_524&ha_version=1.2.1&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=8XBnx4Wz2%2Bx62sMAi5uOPgdjsYc%3D

result

<?xml version="1.0" encoding="UTF-8"?>
<media_get_result>
        <media>
                <mediaid>1ab985e62ce920c2</mediaid>
                <userid>27b723a63cfccb23</userid>
                <title>Homo</title>
                <description/>
                <mediatype>image</mediatype>
                <icon_small>
                        <width>44</width>
                        <height>50</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_1_iQnC.jpeg</src>
                        <fancylayouttag/>
                </icon_small>
                <icon_medium>
                        <width>66</width>
                        <height>75</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_2_iQnC.jpeg</src>
                        <fancylayouttag>[media id=205178878iQnC size=small]</fancylayouttag>
                </icon_medium>
                <icon_large>
                        <width>106</width>
                        <height>120</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_3_iQnC.jpeg</src>
                        <fancylayouttag>[media id=205178878iQnC size=medium]</fancylayouttag>
                </icon_large>
                <icon_extralarge>
                        <width>176</width>
                        <height>200</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_4_iQnC.jpeg</src>
                        <fancylayouttag>[media id=205178878iQnC size=large]</fancylayouttag>
                </icon_extralarge>
                <image>
                        <width>300</width>
                        <height>339</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_5_iQnC.jpeg</src>
                        <fancylayouttag>[media id=205178878iQnC size=xlarge]</fancylayouttag>
                </image>
                <image_fullscreen>
                        <width>300</width>
                        <height>339</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_6_iQnC.jpeg</src>
                        <fancylayouttag/>
                </image_fullscreen>
                <square_large>
                        <width>75</width>
                        <height>75</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_14_iQnC.jpeg</src>
                        <fancylayouttag/>
                </square_large>
                <square_extralarge>
                        <width>120</width>
                        <height>120</height>
                        <src>http://94.100.122.231/205150001-205200000/205178801-205178900/205178878_16_iQnC.jpeg</src>
                        <fancylayouttag/>
                </square_extralarge>
                <url>http://homoapi.hyves.nl/fotos/205178878/0/iQnC/</url>
                <mobileurl>http://www.hyves.nl/mini/hyver/homoapi/fotos/205178878/0/iQnC/</mobileurl>
                <created>1205493772</created>
                <commentscount>239</commentscount>
                <respectscount>1</respectscount>
                <viewscount/>
                <tags>exampletag</tags>
                <geolocation/>
        </media>
        <media>
                <mediaid>979c94838207858d</mediaid>
                <userid>ea5c247f9d076822</userid>
                <title>Gorilla</title>
                <description/>
                <mediatype>image</mediatype>
                <icon_small>
                        <width>46</width>
                        <height>50</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_1_R4lg.jpeg</src>
                        <fancylayouttag/>
                </icon_small>
                <icon_medium>
                        <width>69</width>
                        <height>75</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_2_R4lg.jpeg</src>
                        <fancylayouttag>[media id=205166437R4lg size=small]</fancylayouttag>
                </icon_medium>
                <icon_large>
                        <width>110</width>
                        <height>119</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_3_R4lg.jpeg</src>
                        <fancylayouttag>[media id=205166437R4lg size=medium]</fancylayouttag>
                </icon_large>
                <icon_extralarge>
                        <width>184</width>
                        <height>200</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_4_R4lg.jpeg</src>
                        <fancylayouttag>[media id=205166437R4lg size=large]</fancylayouttag>
                </icon_extralarge>
                <image>
                        <width>400</width>
                        <height>433</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_5_R4lg.jpeg</src>
                        <fancylayouttag>[media id=205166437R4lg size=xlarge]</fancylayouttag>
                </image>
                <image_fullscreen>
                        <width>400</width>
                        <height>433</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_6_R4lg.jpeg</src>
                        <fancylayouttag/>
                </image_fullscreen>
                <square_large>
                        <width>75</width>
                        <height>75</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_14_R4lg.jpeg</src>
                        <fancylayouttag/>
                </square_large>
                <square_extralarge>
                        <width>120</width>
                        <height>120</height>
                        <src>http://94.100.116.115/205150001-205200000/205166401-205166500/205166437_16_R4lg.jpeg</src>
                        <fancylayouttag/>
                </square_extralarge>
                <url>http://gorillaapi.hyves.nl/fotos/205166437/0/R4lg/</url>
                <mobileurl>http://www.hyves.nl/mini/hyver/gorillaapi/fotos/205166437/0/R4lg/</mobileurl>
                <created>1205492027</created>
                <commentscount>1</commentscount>
                <respectscount>1</respectscount>
                <viewscount/>
                <tags/>
                <geolocation>
                        <latitude>12.34560</latitude>
                        <longitude>12.34560</longitude>
                        <visibility>friends_of_friends</visibility>
                </geolocation>
        </media>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>149</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</media_get_result>

returnvalues

Download in other formats:

Plain Text

Context Navigation

TracNav

Hyves-API Home

Specs

methods

global (ha_*) parameters

oAuth

special API zones