The StatusDashboard dashboard public API endpoint allows you to obtain status information for all services programmatically. The dashboard API does not require authentication and can be used to embed status information into your existing websites, either with your own custom code, or using the StatusDashboard Dashboard Widget.
To enable the status dashboard public API endpoint on a specific status dashboard, login to the StatusDashboard administration console and navigate to Status Dashboards > Edit > Dashboard Options > API.
OUTPUT PARAMETERS | |||||||||||
id integer |
The id of the service. |
||||||||||
name |
The name of the service. |
||||||||||
description |
The service description. |
||||||||||
status |
The current status of the service. The possible options are:
|
Examples
Dashboard Status (List method, GET)
* Assumes a subdomain url of https://acme.statusdashboard.com
curl https://acme.statusdashboard.com/api/v1/public/dashboard/ { "meta": { "limit": 100, "next": null, "offset": 0, "previous": null, "total_count": 3 }, "objects": [ { "description": "", "id": 152, "name": "File Server", "status": 1 }, { "description": "http://owa.domain.com", "id": 151, "name": "Exchange Server", "status": 2 }, { "description": "", "id": 150, "name": "Web Site", "status": 0 } ] }
Upon success, you'll receive back an HTTP 200 (OK) indicating that the API call succeeded.