cron.state

返回一个或多个cron的最后状态

认证和信息传输

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

信息传输方法: HTTP GET.

参数

id (可选项)

一个或多个计划任务的ID。如果有多个ID,请用逗号将它们分开

group_id (可选项)

一个或多个计划任务组的ID。如果有多个ID,请用逗号将它们分开。

name (可选项)

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

status (可选项)

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

time_out (可选项)

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

one_off (可选项)

显示或隐藏唯一的计划任务。 使用值 : 1 = 显示/ 0 = 隐藏

page (可选项)

计划任务信息的页数。使用值 : 整数integer

perpage (可选项)

每页上计划任务的数量。使用值 : tout integer. 最大:100. 系统默认值:10

如果没有参数设置,所有的计划任务都将被显示。

 

查询请求实例

http://api.webcron.org/cron.state/id:29123,29124

服务器的反馈回答

<rsp status="ok" total="2" page="1" perpage="10">
   <cron id="29123" name="myCron-1" error="0" status="200" date="2011-08-29 11:00:01" duration="0.6"/>
   <cron id="29124" name="myCron-2"/>
</rsp>

如果没有启动cron的过程中过去七天有,也没有出现错误,状态,日期和时间值(如上与ID =29124)。由于我们只保留最近7天的记录,我们可以不显示旧的反应。