Adding initial API docs

docs/api/making-requests.md

@@ -1,7 +1,39 @@
 # Making requests
 
-## Endpoint
+The Cachet API provides access to incidents and components, allowing you to view, create and update via JSON requests.
 
-## Authorization
+The API is accessible from `http://<cachet-url>/api/<endpoint>`
 
-## Security
+## Examples
+
+You can use curl to interact with the API. There is no authentication required for `GET` requests:
+
+`curl -XGET curl -XGET http://status.cachethq.io/api/components`
+
+In order to create incidents, you must send the a json string with the required payload and authenticate. More information can be found in the Endpoints documentation listed below.
+
+Here's a simple example:
+
+`curl -u username@example.com -H "Content-Type: application/json" -d '{"name":"API","description":"An example description","status":1}' http://status.cachethq.io/api/components`
+
+
+# Endpoints
+
+## `/components`
+List and create components
+
+See [Component API documentation](components.md) for more information
+
+## `/incidents`
+List and create and update incidents
+
+See [Incidents API documentation](incidents.md) for more information
+
+## `/metrics`
+List and add metrics
+
+See [Incidents API documentation](metrics.md) for more information
+
+# Authorization
+
+# Security