Web Service API
It's simple to make requests to Rdio's Web Service API. It’s built on widely used standards and conventions so there are libraries for most common web development platforms.
All method calls are made as POST requests to http://api.rdio.com/1/. Arguments are sent as application/x-www-form-urlencoded, just like when a browser submits a form. The name of the method is passed as the method argument. All of the data going into the API should be UTF-8 encoded, all of the data coming out of the API will be UTF-8 encoded.
All calls must be OAuth signed. This is often referred to as “2-legged OAuth”, where a signature based on the arguments, a nonce, a timestamp and the consumer secret is passed along with the request. Calls that act against a user’s data must be made with an OAuth access token. Read the OAuth documentation for more details.
The API will always return a response form like:
{
"status": "ok",
"result": <the method result>
}
or, in the case of an error:
{
"status": "error",
"message": "<an error message>",
}
The specific nature of the result depends on the method. See the individual method documentation for more details.The API uses JSON natively but if you're developing on a platform that has much better XML support you might want to look at using XML responses.
