cron.contact.bind

读取计划任务的联系方式。联系方式可以在计划任务执行时或计划任务执行有错误的时候得到通知。

认证和信息传输

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

信息传输方法: HTTP POST.

参数

cron_id (注解 1)

计划任务的ID。

cron_name (注解 1)

计划任务的名字。使用值: string (255)

contact_id(注解 2)

联系方式的ID。

contact_name (注解 2)

联系方式的姓名或名称。使用值: string (128)

alert_type (optional)

有两种通知类别。'a' = 每次执行时发出通知,'e' =执行错误时发出通知。使用值: a = 每次/ e= 错误时. 系统默认值:e.

max_sms (optional)

每多少分钟发一个短信通知。联系方式必须是有效的手机号码。使用值: integer (代表分钟). 系统默认值:0.

 

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

 

注解2:为使用方便, contact_idcontact_name。如果此情况出现, contact_id 会被作为关键码来处理

查询请求实例

http://api.webcron.org/cron.contact.bind
传输的信息:
cron_id=154375&contact_name=webmaster&alert_type=e&max_sms=60

服务器的反馈回答

<rsp status="ok">
   <bind contact_id="539" cron_id="154375" />
</rsp>