albums.get

Retrieves a list of albums by albumid.

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

params

• <a href='http://hyves-developers.nl/returnvalues#albumid'>albumid</a> --- Comma-separated list of albumids.
  • 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##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/?albumid=5368e558182cde96&ha_method=albums.get&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117783&oauth_nonce=819728_628&ha_version=1.2.1&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=7OQka2SsPie8vk2YfJ%2BT%2F%2BB%2BPtw%3D

result

<?xml version="1.0" encoding="UTF-8"?>
<albums_get_result>
        <album>
                <albumid>5368e558182cde96</albumid>
                <title>Vrienden</title>
                <mediacount>4</mediacount>
                <userid>ea5c247f9d076822</userid>
                <url>http://gorillaapi.hyves.nl/album/24293666/Vrienden/zF0A-Ku4/</url>
                <visibility>friend</visibility>
                <printability>friend</printability>
                <lastupdate>1282117632</lastupdate>
        </album>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>91</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</albums_get_result>

example 2

url

http://data.hyves-api.nl/?albumid=5368e558182cde96&ha_method=albums.get&ha_responsefields=mobileurl&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117783&oauth_nonce=878212_629&ha_version=1.2.1&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=db8FlV9QuQGzBO7hVSNQM%2F9RcSY%3D

result

<?xml version="1.0" encoding="UTF-8"?>
<albums_get_result>
        <album>
                <albumid>5368e558182cde96</albumid>
                <title>Vrienden</title>
                <mediacount>4</mediacount>
                <userid>ea5c247f9d076822</userid>
                <url>http://gorillaapi.hyves.nl/album/24293666/Vrienden/zF0A-Ku4/</url>
                <mobileurl>http://www.hyves.nl/mini/hyver/gorillaapi/album/24293666/Vrienden/zF0A-Ku4/</mobileurl>
                <visibility>friend</visibility>
                <printability>friend</printability>
                <lastupdate>1282117632</lastupdate>
        </album>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>78</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</albums_get_result>

returnvalues

<a href='http://hyves-developers.nl/returnvalues#album'>album</a>, <a href='http://hyves-developers.nl/returnvalues#albumid'>albumid</a>, <a href='http://hyves-developers.nl/returnvalues#info'>info</a>, <a href='http://hyves-developers.nl/returnvalues#lastupdate'>lastupdate</a>, <a href='http://hyves-developers.nl/returnvalues#mediacount'>mediacount</a>, <a href='http://hyves-developers.nl/returnvalues#mobileurl'>mobileurl</a>, <a href='http://hyves-developers.nl/returnvalues#printability'>printability</a>, <a href='http://hyves-developers.nl/returnvalues#running_milliseconds'>running_milliseconds</a>, <a href='http://hyves-developers.nl/returnvalues#secure_connection'>secure_connection</a>, <a href='http://hyves-developers.nl/returnvalues#timestamp_difference'>timestamp_difference</a>, <a href='http://hyves-developers.nl/returnvalues#title'>title</a>, <a href='http://hyves-developers.nl/returnvalues#url'>url</a>, <a href='http://hyves-developers.nl/returnvalues#userid'>userid</a>, <a href='http://hyves-developers.nl/returnvalues#visibility'>visibility</a>