monitor.get

获得一个或多个监测器的监测结果.

认证和信息传输

此功能需要进行认证authentification。可以通过一般的 HTTP协议或者 HTTPS安全协议。

信息传输方法: HTTP GET.

参数

id (非必选项)

一个或多个监测器的ID。如果有多个ID,请用逗号将它们分开。

group_id (非必选项)

一个或多个监测器组的ID。如果有多个组ID,请用逗号将它们分开。

protocol (非必选项)

监测器的协议。使用值: http / https / ping / ftp

status (非必选项)

监测器的状态。使用值: 1 = 活动状态/ 0 = 非活动状态

frequence (非必选项)

两次监测的间隔时间,以分钟为单位。使用值: 1 / 2 / 3 / 6

page (非必选项)

获得的数据的页数。使用值 : 整数。

perpage (非必选项)

每页上监测器的数量。 使用值:整数. 最大值为100。

如果没有此参数设置,所有监测器的数据或集中在一页上。

查询请求实例

http://api.webcron.org/monitor.get/frequence:2/status:0

服务器的反馈回答

<rsp status="ok" total="1" page="1" perpage="10">
   <monitor id="111" group_id="0" status="0" frequence="2">
      <name>My Monitor</name>
      <url protocol="http">www.checkthisurl.net/monitor</url>
      <login></login>
      <password></password>
      <match contain="1">Server OK</match>
      <post></post>
      <stations total="5" add_stations="1">
         <station id="2">Los Angeles</station>
         <station id="3">Nagano</station>
         <station id="4">Kuala Lumpur</station>
         <station id="8">Washington</station>
         <station id="10">Dallas</station>
      </stations>
      <headers>
         <header>x-myOwnHeader: myValue</header>
      </headers>
      <group id="1202">My group name</group>
      <created>2009-03-04 10:05:57</created>    
      <modified>2009-03-17 07:57:59</modified>
   </monitor>
</rsp>