monitor.add

系统中加入监测器.

认证和信息传输

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

信息传输方法: HTTP POST.

参数

name (必选项)

监测器的名称。使用值: string(64)

protocol (必选项)

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

url (必选项)

监测器的链接。使用值: string(2048)

group_id (非必选项)

监测器所在的组的ID。它必须是一个整数并是一个已经存在的组

group_name (not required, see note)

监测器所在的组的名字。name必须是一个整数并最长不超过64个字符。

status (非必选项)

监测器的状态。使用值: 1 = 活动状态/ 0 = 非活动状态. 系统默认值:1

port (非必选项)

控制端口的号码。使用值: 整数: integer

login (非必选项)

http认证所需要的用户名(username) 使用值: string(32)

password (非必选项)

密码. 使用值: string(32)

match (非必选项)

代表要查找的字段。WebCron在服务器给出的回答中检查是否有或是否包含要查找的字段。使用值: string(255)

contain (非必选项)

确定match项给出的字段是否包含在服务器的回答里。使用值: 1 = 应该包含/ 0 = 不应该包含. 系统默认值:1

do_hash (非必选项)

通过比较hash MD5值是否有内容变化。如果您更换一个现有值,请使用1。使用值:1=检查hash / 0=不检查hash

frequence (非必选项)

两次监测的间隔时间,以分钟为单位。使用值: 1 / 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 15 / 20 / 25 / 30 / 35 / 40 / 45 / 50 / 55 / 60 系统默认值:1

post (非必选项)

所有的信息都必须通过http post传输。格式如下:水果=苹果&饮料=咖啡&甜点=无 . The format should be: pie=apple&drink=coffee&desert=none

stations (not required)

Comma separated list of monitor station id's that will monitor. Allowed values: integer and existing id's. Default: all stations

add_stations (not required)

Add new stations automatically to the list of stations. Allowed values: 1 = yes / 0 = no. Default: 1

 

注解: group_id和group_name可被同时使用。如果此情况出现, group_name不会被作为关键码来处理。

查询请求实例

http://api.webcron.org/monitor.add
传输的信息:
name=1stMonitor&url=www.myserver.com/searchresult.php&protocol=https&match=welcome&
contain=1&frequence=2

服务器的反馈回答

<rsp status="ok">
   <monitor id="74978" />
</rsp>