Cachet/docs/api/making-requests.md
Bennett Blodinger dd225e1321 fix typo
`curl -XGET` is duplicated
2015-01-01 16:53:47 -05:00

1.1 KiB

Making requests

The Cachet API provides access to incidents and components, allowing you to view, create and update via JSON requests.

The API is accessible from http://<cachet-url>/api/<endpoint>

Examples

You can use curl to interact with the API. There is no authentication required for GET requests:

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 for more information

/incidents

List and create and update incidents

See Incidents API documentation for more information

/metrics

List and add metrics

See Incidents API documentation for more information

Authorization

Security