agenda-rest
Scheduling as a Service, based on Agenda
Assuming all job types could be thought of as REST endpoints, scheduling could be offered as a service. agenda-rest
does just that, introduce a URL, name it, agenda-rest will call it on the times that you specify.
Installation
Install agenda-rest as a global package
npm install -g agenda-rest
Usage
To launch the agenda-rest server, use the command line interface specifying the database host name and the database name
agenda-rest --dbhost localhost --dbname agenda
Command Line Interface options
Options | Description |
---|---|
-d, --dbname |
[optional] Name of the Mongo database, default is agenda |
-h, --dbhost |
[optional] Mongo instance's IP or domain name, default is localhost |
-u, --dburi |
[optional] Full Mongo connection string. If specified, will override --dbhost, --dbname |
-p, --port |
[optional] agenda-rest server port, default is 4040 |
-k, --key |
[optional] x-api-key to be expected in headers. If not specified, access to agenda-rest server would be unauthenticated |
-t, --timeout |
[optional] Timeout for request duration, default is 5000 ms |
APIs
/api/job
GET Get a list of defined jobs
- Method: GET
/api/job
POST Defines a new category of jobs
- Method: POST
- Data:
name // New job type's name url // koa-router style url method // (optional) Request type, default: POST callback: // (optional) to call with response after invocation url method headers
/api/job/:jobName
PUT Updates definition of a job category
- Method: PUT
- Data: same as POST
/api/job
/api/job/:jobName
DELETE Deletes job definition and cancels occurrences
- Method: DELETE
/api/job/once
& POST /api/job/every
POST Schedule a job for single or multiple occurrences
- Method: POST
- Data:
name // Name of the type to create the instance from interval // Interval in which job should be invoked (human-interval, can also be a date string for 'once') data: // (optional) default: {} headers // Http headers, e.g. { Authorization: '<token>' } params // Path parameters, to replace `:param` notations in job definition's url query // Query parameters (?foo=bar&baz=qux) body // Accompanying data sent along the request
Callback, if present, would be invoked by the following object:
data: // passed data object, same as above response // response from invocation
/api/job/now
POST Like once
and every
, though without interval
. Executes the job now.
/api/job/cancel
POST Cancels (not to be confused with 'delete') any jobs matching the query
- Method: POST
- Data: Mongo query
name: "foo"