monitor.contact.bind

将一个联系方式与一个监测器联系起来。您可以同过该联系方式在服务器出现问题时收到监测器发出的警告。

认证和信息传输

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

信息传输方法: HTTP POST.

参数

monitor_id (必选项, 注解 1)

监测器的ID。必须是整数。

monitor_name (必选项, 注解 1)

监测器的名称。必须是字段 (string), 最多 64 个字符。

contact_id (必选项, 注解 2)

联系方式的ID。必须是整数。

contact_name (必选项, 注解 2)

联系方式的名称。必须是字段 (string), 最多 64 个字符。

delay (非必选项)

警告发出前的时间。0=发现错误立即发出, 1 = 第一次检查后, 2 =第一次检查后,等等。如果您的监测器的监测频率是每2分钟一次,警告发出时间设置为3,监测器将在第三次监测也就是6分钟后发出警告。必须是整数。系统默认值:0

alert_type (非必选项)

2种警告类型。'a' = 错误警告, 'r' =错误警告和服务器恢复时再通知。 使用值:a =错误警告/ r =错误警告和服务器恢复时再通知。 系统默认值:a 错误警告和服务器恢复时再通知。 系统默认值:a

 

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

 

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

查询请求实例

http://api.webcron.org/monitor.contact.bind
contact_id=1983&monitor_id=52319&delay=2&alert_type=r

服务器的反馈回答

<rsp status="ok">
   <bind contact_id="1983" monitor_id="52319" />
</rsp>