nci rest api server

REST api server for nci.

Installation

``sh
npm install nci-rest-api-server
`

Usage

To enable add this plugin to the plugins section at server config:

`json
{
"plugins": [
"nci-rest-api-server"
],
"http": {
"host": "127.0.0.1",
"port": 3000,
"url": "http://127.0.0.1:3000"
},
....
}
`

after that you can access api according to your server http.host and
http.port options.

API routes

Notes:

- Currently destructive api methods (project removing/renaming)
protected by token which could be set at config (http.apiAccessToken field)
or will be generated and printed to the server log during server startup.
Client should send token as token field at request body.
- Currently server respond format is only json.

$3

Get builds sorted by date in descending order.

Query parameters:
- project - optional project filter
- limit - maximum builds count to get (20 by default)

$3

Get particular build by id.

$3

Create build by running given project.

Body parameters:
- project - project to build
- withScmChangesOnly - if true then build will be started only if
there is scm changes for project
- queueQueued - if true then currently queued project can be queued
again

$3

Update build.

Body parameters:
- cancel - if set to true then build will be canceled

$3

Get configs for all currently loaded projects.

$3

Get particular project by name.

$3

Create new project and set config.

Body parameters:
- name - project name
- config - project configuratjion object
- configFile - project config file object with name and content fields
(it's alternative for config option when need to set file in specific format)
- loadConfig - if true then project will be loaded

$3

Modify project.

To rename project, body parameters:
- name - new project name

To set project config, body parameters:
- config - project configuratjion object
- configFile - project cconfig file object with name and content fields
(it's alternative for config option when need to set file in specific format)
- loadConfig - if true then project will be loaded

To archive/unarchive project, body parameters:
- archived` - boolean, new state of the project

$3

Remove project.