Each cronjob contains these members:
Name | Type | Description |
---|---|---|
id | integer | ID |
group | integer | Group ID, null means "None" |
expression | string | Cron expression
(crontab syntax e.g. 0 12 * * 1-5
or English description e.g. 1 day; 65 minutes; 1 min 30 sec)
|
timezone | string | Time zone |
url | string | URL to call |
httpMethod | string | The HTTP Method to send HTTP requests to your URL. |
httpHeaders | string | Plain HTTP headers to send to your cronjob URL. Use new lines as delimiters, e.g.
X-API-Key: 123ABC456XYZ
|
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 | bool | Notify when cronjob fails |
points | integer | Points, number of executions per day |
Here's the list of cronjob 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 because of account daily execution limit |
4 | STATUS_FAILED | Disabled due to many consecutive failures |
Each cron execution results contains these members:
Name | Type | Description |
---|---|---|
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 requests to. |
output | string | Your cronjob output, including HTTP headers and body. Only first 4 KB and last 4 KB, 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. |
time | integer | Unix timestamp of scheduled time. |
startTime | decimal | Unix timestamp of starting time with milliseconds. |
executionTime | decimal | Total execution time, in seconds. |
status | integer | Execution status, 0 means "success" |
Each group contains these members:
Name | Type | Description |
---|---|---|
id | integer | ID |
name | string | Name |
autoDelete | integer | Automatically delete stopped (one-time) cronjobs. 0 for never; 1, 3, 7, 15, 30 for days. |
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
.