Data structures

Cronjob

Each cronjob contains these members:

Name Type Description
id integer ID
group integer Group ID, null means "None"
second array(string) Second values (only 0 and/or 30 is allowed)
minute array(string) Minute values
hour array(string) Hour values
day array(string) Day values
month array(string) Month values
weekday array(string) Weekday values
year string Specific year to run cronjob (empty for every year)
timezone string Time zone
url string URL to call
httpMethod string The HTTP Method to send HTTP request to your URL.
httpHeaders string Headers of the HTTP request to send to your cronjob URL.
postData string The data to POST to your URL
fail integer Number of consecutive failures
status integer Status code, 0 means "active"
name string Name of cronjob
notify integer Notification settings
points integer Points, number of executions per day

Status codes

Here's the list of cronjob's status codes:

Value Name Description
0 STATUS_ACTIVE Cronjob is active and running
1 STATUS_DISABLED Disabled by user
2 STATUS_EXPIRED Disabled due to account expired
3 STATUS_INACTIVE Disabled due to not enough account points
4 STATUS_FAILED Disabled due to many consecutive failures

Notification settings

Here's the list of notification setting codes:

Value Name Description
0 NOTIFY_NEVER Never send you any notification
1 NOTIFY_FAILURE Notify you when cronjob fails
2 NOTIFY_ALWAYS Notify you when cronjob is executed
3 NOTIFY_DISABLED Notify you only when cronjob disabled because of multiple consecutive failures

Cron execution result

Each cron execution results contains these members:

Name Type Description
jobId integer Cronjob ID
no integer Execution no.
result array An array contains multiple values, see below.

result contains these members:

Name Type Description
url string The actual URL that our bot sent HTTP request to.
output string Your cronjob output, including HTTP headers and body. Only first 4KB and last 1KB, the remaining is truncated.
downloaded integer Total output size (in bytes).
httpStatus integer HTTP status code e.g. 200
error string Error message, if any.
message string System message, if any
ip string Destination IP.
source_ip string IP address of the bot that process your cronjob.
startTime integer Unix timestamp of starting time.
executionTime decimal Total execution time, in seconds.
status integer Execution status, 0 means "success"

Group

Each group contains these members:

Name Type Description
id integer ID
name string Name

Supported timezones

There are two types of timezone: real timezone e.g. Europe/London, and displaying timezone e.g. (UTC+1) Europe/London. Our data structures and parameters' timezone field works with real timezone only.

You can get the list of supported timezones at server.timezones.

Warning: If you send request using URL parameters, please escape your timezone (and all other variables' values) using a URL encoding function e.g. PHP's rawurlencode.