About this call

This call returns all the checks for a domain's availability since a given date.  This call returns historical data.

Format

http://api.chartbeat.com/historical/dashapi/uptime/?host=[host]&since=[timestamp]&apikey=[apikey]

• host - Required.  The domain name to get uptime data about.
• since - Required.  Unix timestamp.  Returns all uptime data since this time.
• apikey - Required.  An api key generated here that gives access to this call.
• jsonp - Optional.  Give the name of a function to wrap the return data in. Learn more here

Example

http://chartbeat.com/dashapi/uptime/?host=chartbeat.com&since=1231194225&apikey=abc123

Example return:

{

"2009-01-06": {

"snaptime": [  "2009-01-06 20:56:00",

"2009-01-06 20:57:00",

"2009-01-06 20:58:00"

],

"loadtime": [51, 40, 56],

"valid": [1, 1, 1],

"errmsg": ["", "", ""],

"servers": [2, 2, 2]

},

"2009-01-07": {

"snaptime": [  "2009-01-07 20:56:00",

"2009-01-07 20:57:00",

"2009-01-07 20:58:00"

],

"loadtime": [51, 40, 56],

"valid": [1, 1, 0],

"errmsg": ["", "", "The requested URL returned error: 500"],

"servers": [2, 2, 2]

}

}
 

Return variables

Returns an associative array, keyed on the day.  Each day is broken down into five arrays.  Each item in the five arrays all correspond with each other (so valid[0] and errmsg[0] and servers[0]... all correspond).

This call returns data for every minute.  The example has been truncated for easy reading.

• snaptime - The time the uptime check was done.  Usually every minute.
• loadtime - The number of milliseconds it took for the page to be returned to the server.
• valid - (possible values: 1 or 0).  1 if the page returned with no errors, 0 otherwise.
• errmsg - The error message returned when trying to get the page.  Blank if no error.
• servers - The number of chartbeat servers that verified the uptime.  "loadtime" is the average between these servers.  A page will only be returned as invalid if all servers received the same error message at the same time.