RunMeLater.com

Web Service for CRON Jobs/Scheduled Tasks

API Overview

Url: http://www.runmelater.com/add/

Standard Request Parameters
url: Url of the Http-based task
email: Email Address to notify when task is completed.

Response Values (JSON format)
status: 'success' or 'fail'
id: Task Id
message: if status = 'fail', description of error.

Other Info:

All dates and times should be in UTC. Support for other timezones will be provided in the future. Current Utc Time: 2012-02-01 00:13:52.

Hours should be in 24-hour mode (e.g. 14:30 for 2:30pm).

Tasks run on every 10th minute of the hour (e.g. 1:10, 12:20, 3:50).

Tasks have a limit on up to how many times it can run. Daily = 30 times; Weekly = 12 times; Monthly = 3 times. Once the limit is reached, the task will not be ran anymore.

For questions or suggestions, email

contact _at_ runmelater.com

Built by dannyroa
One-Time Task

Request Parameters

wait (required if 'date' and 'time' not provided): Wait time before running the task.
Format: xx+type
Sample: 10+m (10 minutes); 1+h (1 hour)

date (required if 'wait' not provided): Date you want the task to run.
Format: yyyy-mm-dd

time (required if 'wait' not provided): Hour and minute you want the task to run.
Format: hh:ss

timezone (Not yet implemented; optional): Timezone of the specified time.
Default: Utc

Example 1

Request
http://www.runmelater.com/add/?wait=15+m&url=http://mysite.com/job1&email=demo@runmelater.com

Response
{"status": "success", "id": "4gEX5_4023"}

Example 2

Request
http://www.runmelater.com/add/?date=2010-01-02&url=http://mysite.com/job2&time=10:20&email=demo@runmelater.com

Response
{"status": "success", "id": "r5aRU_4047"}

Recurring Task

Request Parameters

repeat: Recurrence Type. Possible values: 'daily', 'weekly', 'monthly'.

day (required for 'weekly' or 'monthly' only): If 'weekly', use 0 for Sunday ... 6 for Saturday. Default is 0 (Sunday) if not provided. If 'monthly', use day of the month. Default is 1 for the 1st day of the month.

time: Hour and minute you want the task to run.
Format: hh:ss

timezone (Not yet implemented; optional): Timezone of the specified time.
Default: Utc

Example 1 (Daily Task)

Request
http://www.runmelater.com/add/?repeat=daily&url=http://mysite.com/job3&email=demo@runmelater.com&time=01:00

Response
{"status": "success", "id": "PzwJK_5519"}

Example 2 (Weekly Task)

Request
http://www.runmelater.com/add/?repeat=weekly&url=http://mysite.com/job4&day=3&email=demo@runmelater.com&time=05:30

Response
{"status": "success", "id": "blMKx_5649"}

Example 3 (Monthly Task)

Request
http://www.runmelater.com/add/?repeat=monthly&url=http://mysite.com/job5&day=15&email=demo@runmelater.com&time=9:00

Response
{"status": "success", "id": "lLQsQ_5923"}