Making Requests

---

The breathe API uses the JSON-over-HTTP architecture that is widely used within web-based API system. Broadly, this means that:

• The type of action to be carried out is determined by a request’s URL and its HTTP method
• Any data to be submitted is sent in the form of a JSON document in the body of a POST request
• Additional parameters may be sent in the URL query string
• All responses are in the form of JSON documents
• The HTTP response code will give additional information as to the outcome of the request

Over the following pages we will detail the conventions used within the breathe API.