APIMethods/1.2.1/gadgets.get

TracNav

TracNav

gadgets.get

Retrieves a list of gadgets by gadgetid.

params

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:

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/?gadgetid=9bddbad06469e79b&ha_method=gadgets.get&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117694&oauth_nonce=788_527&ha_version=1.2.1&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=NCllGmlNIv%2FCOPRpXzqeL9nIJZY%3D

result 

<?xml version="1.0" encoding="UTF-8"?>
<gadgets_get_result>
        <gadget>
                <gadgetid>9bddbad06469e79b</gadgetid>
                <title>Homo Sapiens</title>
                <html>&lt;object width=&quot;425&quot; height=&quot;355&quot;&gt;&lt;param name=&quot;movie&quot; value=&quot;http://www.youtube.com/v/GL6yjDKINU8&quot;&gt;&lt;/param&gt;&lt;param name=&quot;wmode&quot; value=&quot;transparent&quot;&gt;&lt;/param&gt;&lt;embed src=&quot;http://www.youtube.com/v/GL6yjDKINU8&quot; type=&quot;application/x-shockwave-flash&quot; wmode=&quot;transparent&quot; width=&quot;425&quot; height=&quot;355&quot;&gt;&lt;/embed&gt;&lt;/object&gt;</html>
                <specurl/>
                <maycopy>true</maycopy>
                <userid>27b723a63cfccb23</userid>
                <url>http://homoapi.hyves.nl/widget/25446174/Homo_Sapiens/FUic/</url>
                <visibility>superpublic</visibility>
        </gadget>
        <info>
                <timestamp_difference>1</timestamp_difference>
                <running_milliseconds>134</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</gadgets_get_result>
example 2

url 

http://data.hyves-api.nl/?gadgetid=9bddbad06469e79b&ha_method=gadgets.get&ha_responsefields=commentscount%2Crespectscount%2Cfancylayouttag%2Cviewscount&oauth_consumer_key=Nl-SK2c5ZCBKB_I8hCF_zjPd&oauth_timestamp=1282117695&oauth_nonce=213734_528&ha_version=1.2.1&oauth_signature_method=HMAC-SHA1&ha_format=xml&ha_fancylayout=false&oauth_signature=abXjNPC8F1oquQ0HWxMjE93cPQg%3D

result 

<?xml version="1.0" encoding="UTF-8"?>
<gadgets_get_result>
        <gadget>
                <gadgetid>9bddbad06469e79b</gadgetid>
                <title>Homo Sapiens</title>
                <html>&lt;object width=&quot;425&quot; height=&quot;355&quot;&gt;&lt;param name=&quot;movie&quot; value=&quot;http://www.youtube.com/v/GL6yjDKINU8&quot;&gt;&lt;/param&gt;&lt;param name=&quot;wmode&quot; value=&quot;transparent&quot;&gt;&lt;/param&gt;&lt;embed src=&quot;http://www.youtube.com/v/GL6yjDKINU8&quot; type=&quot;application/x-shockwave-flash&quot; wmode=&quot;transparent&quot; width=&quot;425&quot; height=&quot;355&quot;&gt;&lt;/embed&gt;&lt;/object&gt;</html>
                <specurl/>
                <maycopy>true</maycopy>
                <userid>27b723a63cfccb23</userid>
                <url>http://homoapi.hyves.nl/widget/25446174/Homo_Sapiens/FUic/</url>
                <visibility>superpublic</visibility>
                <commentscount>240</commentscount>
                <respectscount>1</respectscount>
                <fancylayouttag>[gadget]&lt;object width=&quot;425&quot; height=&quot;355&quot;&gt;&lt;param name=&quot;movie&quot; value=&quot;http://www.youtube.com/v/GL6yjDKINU8&quot;&gt;&lt;/param&gt;&lt;param name=&quot;wmode&quot; value=&quot;transparent&quot;&gt;&lt;/param&gt;&lt;embed src=&quot;http://www.youtube.com/v/GL6yjDKINU8&quot; type=&quot;application/x-shockwave-flash&quot; wmode=&quot;transparent&quot; width=&quot;425&quot; height=&quot;355&quot;&gt;&lt;/embed&gt;&lt;/object&gt;[/gadget]</fancylayouttag>
                <viewscount/>
        </gadget>
        <info>
                <timestamp_difference>0</timestamp_difference>
                <running_milliseconds>100</running_milliseconds>
                <secure_connection>false</secure_connection>
        </info>
</gadgets_get_result>

returnvalues

<a href='http://hyves-developers.nl/returnvalues#commentscount'>commentscount</a>, <a href='http://hyves-developers.nl/returnvalues#fancylayouttag'>fancylayouttag</a>, <a href='http://hyves-developers.nl/returnvalues#gadget'>gadget</a>, <a href='http://hyves-developers.nl/returnvalues#gadgetid'>gadgetid</a>, <a href='http://hyves-developers.nl/returnvalues#html'>html</a>, <a href='http://hyves-developers.nl/returnvalues#info'>info</a>, <a href='http://hyves-developers.nl/returnvalues#maycopy'>maycopy</a>, <a href='http://hyves-developers.nl/returnvalues#respectscount'>respectscount</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#specurl'>specurl</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#viewscount'>viewscount</a>, <a href='http://hyves-developers.nl/returnvalues#visibility'>visibility</a>