REST API: Difference between revisions
No edit summary |
No edit summary |
||
| Line 2: | Line 2: | ||
The REST API is exposed by both the standalone and bundled versions of the admin web application. | The REST API is exposed by both the standalone and bundled versions of the admin web application. | ||
==Endpoints== | ==Endpoints== | ||
| Line 20: | Line 18: | ||
The REST API is secured by limiting access to users configured in [[Admin User Management|User Management]] with the API Access role. | The REST API is secured by limiting access to users configured in [[Admin User Management|User Management]] with the API Access role. | ||
Valid [http://en.wikipedia.org/wiki/Basic_access_authentication basic access authentication] must be supplied with every request. | Valid [http://en.wikipedia.org/wiki/Basic_access_authentication basic access authentication] must be supplied with every request. Valid API users are authorized to access any REST endpoint. | ||
Revision as of 22:46, 5 January 2013
Obsidian provides a REST API to ease integration into other applications and software environments. A complete range of job and scheduling features are exposed via the API.
The REST API is exposed by both the standalone and bundled versions of the admin web application.
Endpoints
The API is exposed under the path "/rest".
For example, if your web application is deployed at localhost, the jobs endpoint is accessible at "http://localhost/rest/jobs".
Data Format
JSON is used for all endpoints. This includes response data and PUT/POST data.
The returned Content-Type will always be "application/json".
All PUTs and POSTs must include Content-Type header set to "application/json".
Authentication/Authorizaton
The REST API is secured by limiting access to users configured in User Management with the API Access role.
Valid basic access authentication must be supplied with every request. Valid API users are authorized to access any REST endpoint.
