APIMethods/beta_2/albums.create – hyves_api

Context Navigation

albums.create

Creates an album for logged in user.

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

params

<a href='http://hyves-developers.nl/returnvalues#title'>title</a> --- Title of the album.
- Required

<a href='http://hyves-developers.nl/returnvalues#visibility'>visibility</a> --- The visibility of the album.
- Required
- Possible values:
  - friend --- visible only to the friends of the user.
  - friends_of_friends --- visible only to the friends of the user and their friends.
  - public --- visible only to all logged in hyvers.
  - superpublic --- visible only to all (whether logged in or not).
  - default --- default visibility, as presented to Hyver on website (note: may involve settings, not a static result).
  - private --- visible to owner.

<a href='http://hyves-developers.nl/returnvalues#printability'>printability</a> --- The printability of the album.
- Required
- Possible values:
  - friend --- visible only to the friends of the user.
  - friends_of_friends --- visible only to the friends of the user and their friends.
  - public --- visible only to all logged in hyvers.
  - superpublic --- visible only to all (whether logged in or not).
  - default --- default visibility, as presented to Hyver on website (note: may involve settings, not a static result).
  - private --- visible to owner.

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

For this function to work, you need to supply a valid access token to oauth_token.
For more information on oAuth, see <a href='http://www.hyves-developers.nl/documentation/data-api/hyves-api-oauth/'>http://www.hyves-developers.nl/documentation/data-api/hyves-api-oauth/</a>.
Please provide some kind of user feedback when an item is created.

examples

example 1

url

http://data.hyves-api.nl/?title=Vacation%202008&visibility=default&printability=default&oauth_token=YXRfMTc3OTgxNTE5XyzzKhdJ9P0p-9URPI6SeeU%3D&ha_method=albums.create&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117632&oauth_nonce=946334_396&ha_version=beta_2&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=%2BgJmGZeRaVi4IJjkdC2j7Pf9Zq8%3D

result

<?xml version="1.0" encoding="UTF-8"?>
<albums_create_result>
        <album>
                <albumid>005074f7e79ae301bf25c5a1ce34b12dcd</albumid>
                <title>Vacation 2008</title>
                <mediacount>0</mediacount>
                <userid>00cc68f39949140377bebf54013a15f63f</userid>
                <url>http://gorillaapi.hyves.nl/album/53684767/Vacation_2008/40qQYCsa/</url>
                <visibility>private</visibility>
                <printability>private</printability>
                <lastupdate>0</lastupdate>
        </album>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>95</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</albums_create_result>

example 2

url

http://data.hyves-api.nl/?title=Vacation%202008&visibility=default&printability=default&oauth_token=YXRfMTc3OTgxNTE5XyzzKhdJ9P0p-9URPI6SeeU%3D&ha_method=albums.create&ha_responsefields=mobileurl&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117632&oauth_nonce=944437_397&ha_version=beta_2&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=UgbtZmcu19FDIGLj9ZFaj2BydSo%3D

result

<?xml version="1.0" encoding="UTF-8"?>
<albums_create_result>
        <album>
                <albumid>00b07121f8404606659db3587e124f439d</albumid>
                <title>Vacation 2008</title>
                <mediacount>0</mediacount>
                <userid>00cc68f39949140377bebf54013a15f63f</userid>
                <url>http://gorillaapi.hyves.nl/album/53684768/Vacation_2008/9S09TiOq/</url>
                <mobileurl>http://www.hyves.nl/mini/hyver/gorillaapi/album/53684768/Vacation_2008/9S09TiOq/</mobileurl>
                <visibility>private</visibility>
                <printability>private</printability>
                <lastupdate>0</lastupdate>
        </album>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>99</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</albums_create_result>

returnvalues

Download in other formats:

Plain Text

Context Navigation

TracNav

Hyves-API Home

Specs

methods

global (ha_*) parameters

oAuth

special API zones