The API Console

First of all, the API console is only an extra help we have for API development, and not a product in itself. Therefor we do not make explicit guarantees about it's availability or back/forwards compatibility.

The API Console was developed and tested using Firefox 2.0.0.x; it may or may not work on other browsers.

The API Console uses "console.log" to display logmessages/debug messages. We suggest installing firebug so that you can see these messages (we suggest installing firebug period :) )

The API console can be found at http://www.hyves.nl/api/console. Just fill in all bold fields (you don't have to urlencode the values), and press "Go". Note that the API console is 100% javascript; your oauth_consumer_secret and oauth_token_secret are not getting sent over the internet.

The following fields need some extra description

  • http_method. Allows to select the HTTP method. This only influences the oauth_signature, not the actual method used for the call to the iframe.
  • url. Make sure it has at least a slash after the hostname
  • oauth_version If you want to change this (this will result in an illegal call), use the following code in the firebug javascript console:
    $('oauth_version').value="2.0"
    
  • oauth_timestamp. If you want to set this manually, use the following code in the firebug javascript console:
    window.clearInterval(timestampupdater);
    $('oauth_timestamp').value=12345
    
  • Load directly in iframe: If ticked, the url is loaded directly into the iframe. This means that the timestamp/nonce is used and invalidated immediately, so you cannot call the resulting url manually.

Debugging oauth signature calculation

To help you in your oauth_signature calculation, the API console logs the normalizedparameters, the basestring and the key to the console.log (if available), which will put it in the firebug javascript console. Hopefully this will help you if you have a problem.