查询格式(REST)

REST查询很容易理解。它是一个HTTP GET 或 HTTP POST 命令。

有的功能要用GET而其它的需要POST. 基本原理是GET是用来从服务器上获得数据,而POST是用来向服务器上传递数据。您可以从我们的解释中了解每个功能所需使用的命令。

Url

所有查询的网址是:https://api.webcron.org/
非安全网址是:  http://api.webcron.org/

例子

https://api.webcron.org/monitor.get/frequence:1,2/protocol:http

在“api.WebCron.org/”后面的部分就是一个查询功能. 在上面的例子中, 功能是 monitor.get. 在功能的后面您可以加入参数。参数格式如下:参数名:参数值(name:value) 或者是参数名:参数值,参数值,参数值 name:value1,value2,value3

POST法发送数据和编码

对发布的数据格式如下:“字段名称=值“

name=theName&url=http%3A%2F%2Fwww.dothis.com%2Fdo.php%3Fwhat%3Dbackup&frequence=2&
post=what%3Dbackup%26when%3Dnow

对用POST方法发送的所有数据都应当正确编码。在上面的例子中,在“url“和“post“字符串进行编码。大多数语言都有一个函数来做到这一点(php:用urlencode(),JavaScript的:escape())。。或使用在线编码工具 .

cURL POST法发送数据样例

以下是一个用 cURL. 来加监视器的例子。请用您自己的用户名和密码.

curl -u ApiUsername:ApiPassword -d name='theName' -d url='http://www.monitorthis.net' -d protocol=http -d frequence=2 api.webcron.org/monitor.add