Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Use SSL for the example requests

  • Loading branch information...
commit a4a2bf8f188b727f2c9627cae2e8eb3c7ef14951 1 parent 5f511c5
@jdelStrother jdelStrother authored
Showing with 7 additions and 7 deletions.
  1. +7 −7 sections/request_formats.md
View
14 sections/request_formats.md
@@ -7,12 +7,12 @@ Being a REST-style API, all calls are made to paths based on the resource you're
For example, if you're trying to access a list of clips a user is following, you'll make HTTP `GET` request to:
-`http://api.audioboo.fm/users/12/audio_clips/followed`
+`https://api.audioboo.fm/users/12/audio_clips/followed`
where 12 is the id of the user you're interested in. See [Response Encoding](https://github.com/audioboo/api/blob/master/sections/request_formats.md#response-encoding) below to find out what encodings we can use in responses.
If you were trying to upload a clip to the linked user, you'd make a HTTP `POST` to:
-`http://api.audioboo.fm/account/audio_clips`
+`https://api.audioboo.fm/account/audio_clips`
## Standard Parameters ##
To enable us to track what version of the API specification you have used to write your application, you should always include a `version` parameter along with the parameters of the API you are calling.
@@ -34,12 +34,12 @@ We have internally simplified returned data into series of hashes, arrays and ba
Thus, both the following commands are equivalent:
```
- curl http://api.audioboo.fm/audio_clips.xml
- curl -H"Accept: application/xml" http://api.audioboo.fm/audio_clips
+ curl https://api.audioboo.fm/audio_clips.xml
+ curl -H"Accept: application/xml" https://api.audioboo.fm/audio_clips
```
###Examples:
-`curl http://api.audioboo.fm/audio_clips.json`
+`curl https://api.audioboo.fm/audio_clips.json`
```json
{
@@ -78,7 +78,7 @@ Thus, both the following commands are equivalent:
...
```
-`curl http://api.audioboo.fm/audio_clips.xml`
+`curl https://api.audioboo.fm/audio_clips.xml`
```xml
<?xml version="1.0" encoding="UTF-8"?>
@@ -139,4 +139,4 @@ For failed requests, the server will typically return a suitable status value. I
API failures caused by errors in the request will have two HTTP headers added to the server’s response, `X-Audioboo-Error_code` and `X-Audioboo-Error_description`. The failure in this case is due to a failure between the client and the server, such as invalid signature or disabled service or source keys on the server.
-A special case to this is the Audioboo error code 800, which indicates that the API version attached to the request sent is out of date and not supported by the server. In this case, it would be a wise idea to display the description sent by the server directly to the user as this will probably contain instructions on updating the client. No further attempts should be made to communicate with the server as they will result in the same response.
+A special case to this is the Audioboo error code 800, which indicates that the API version attached to the request sent is out of date and not supported by the server. In this case, it would be a wise idea to display the description sent by the server directly to the user as this will probably contain instructions on updating the client. No further attempts should be made to communicate with the server as they will result in the same response.
Please sign in to comment.
Something went wrong with that request. Please try again.