cron.add

加入一个计划任务.

认证和信息传输

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

信息传输方法: HTTP POST.

参数

name (必选项)

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

url (必选项)

计划任务的链接。使用值: string (2048)

status (可选项)

计划任务的状态。使用值: 1 = enabled / 0 = disabled. 系统默认值: 1

time_out (可选项)

计划任务的超时,以秒计算。 使用值: 30 / 180 / 600 / 1800 / 3600. 系统默认值: 30

login (可选项)

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

password (可选项)

http认证所需要的密码(password). 使用值: string(32)

year (可选项)

确定计划任务执行的年份。如果有多于一个的值,值之间用逗号分开。使用值: integer (4) 或 * (= 每年). 系统默认值:*。

month (可选项)

确定计划任务执行的月份 (1 = 一月, 2 = 二月,等等).。如果有多于一个的值,值之间用逗号分开。使用值: integer 1 à 12 ou * (= 每月). 系统默认值:*。

weekday (可选项)

确定计划任务执行的在一周里的日子 (1 = 周一, 2 = 周二,等等)。如果有多于一个的值,值之间用逗号分开。使用值: integer 1 到 7 或 * (= 一周力的每一天). 系统默认值:*。

day (可选项)

确定计划任务执行的在月份里的日子。如果有多于一个的值,值之间用逗号分开。使用值: integer 1 到 7 或 * (= 一月里的每一天). 系统默认值:*。

hour (可选项)

确定计划任务执行的小时。如果有多于一个的值,值之间用逗号分开。使用值: integer 0 到 23 或 * (= 每小时). 系统默认值:*。

minute (可选项)

确定计划任务执行的分钟。如果有多于一个的值,值之间用逗号分开。使用值: integer 0 到 %( 或 * (= 每分钟). 系统默认值:*。

exec_delay (可选项)

确定计划任务执行的时间。单位为分钟。 此参数不可以和其它时间参数并用。使用值: integer.

查询请求实例

http://api.webcron.org/cron.add
POST data:
name=1stcron&url=http://www.url.com/mycron.php&time_out=180&login=myname&
password=mypasswd&weekday=3,6&hour=5&minute=20

传输的信息

<rsp status="ok">
   <cron id="154375" />
</rsp>