This API gives the appropriate links to view the consolidated uptime and response time report for all monitors over a specific time period.
Request URL
Below is a sample request for listing the consolidated uptime & response time report:
http://site24x7.com/api/xml/consolidatedreports?apikey=[APIKEY]
|
For example,
http://site24x7.com/api/xml/consolidatedreports?apikey=f98394a9538975fe3ba18e1501e3ecb1
|
If you want to view the reports for a specific time period, you should
specify the time period as part of the url as given below:
http://site24x7.com/api/xml/consolidatedreports?/custom/[FROMDATE]/[TODATE]?apikey=[APIKEY]
For example,
http://site24x7.com/api/xml/consolidatedreports/custom/2009-03-07 14:30/2009-04-07 14:30?apikey=f98394a9538975fe3ba18e1501e3ecb1
If you want to view the reports for a specific time period, you should specify the time period as part of the url.
Sample Success Response
The below sample response gives a link to view the consolidated uptime and response time report of all the monitors.
<response uri="/api/xml/consolidatedreports" action="ConsolidatedReports"> <result> <response> <group name="me"> <monitor displayname="MyCorporate" monitortype="URL" report="http://site24x7.com/login/status.do?execute=StatusReport¶m=s29C%2BqlYJKPVfceEqj2r3xNEuDDOBj3QobJHRY0Xr3U%3D&period=2 &urlid=2000000004003&color=%23FFFFFF"/> <monitor displayname="MyMonitor" monitortype="URL" report="http://site24x7.com/login/status.do?execute=StatusReport¶m=s29C%2BqlYJKPVfceEqj2r3xNEuDDOBj3QobJHRY0Xr3U%3D&period=2 &urlid=2000000007003&color=%23FFFFFF"/> </group> </response> </result> </response> |
Errors
Viewing consolidated reports of monitors might return some errors depending
on the parameters specified. Below is a sample response if the url is
incorrect.
<response uri="/api/xml/consolidatedreports"> <error> <code>2891</code> <message>The specified request URI is incorrect</message> </error> </response> |