@artifacter/webapi

Artifacter's artifacts webapi core connector

Checkout Github's parsed README for a better visualization! -> https://github.com/arthmoeros/artifacter-webapi

What's this? - Intro

This is Artifacter's Web API connector for the core (previously coupled with @artifacter/core), it makes use of the core module to expose all its API via a RESTful API.

How do I use this?

You can git clone this same repo and start it just like this

git clone https://github.com/arthmoeros/artifacter-webapi/
npm install
npm start

...or use it as a npm package, and start it using the provided bin

npm install --save @artifacter/webapi
node_modules/.bin/artifacter-serve

In both cases, by default the config and temporary directories are within the core base folder, you can customize these paths using the environment variables ARTIFACTER_CONFIG and ARTIFACTER_TMP, here is a unix example:

# Default is ./config
export ARTIFACTER_CONFIG=/etc/artifacter_custom
# Default is ./tmp
export ARTIFACTER_TMP=/var/artifacter_custom

What's in here? - API

Artifacter's Web API runs as an expressJS server, it has the same 4 services available in the API as the core, via RESTful.

Get Form Configurations list

Resource | Method | Request ContentType | Response ContentType -------- | ------ | --------------------- | ----------------------- /forms | GET | application/x-www-form-urlencoded | application/json

Retrieves a list of presumably valid form configurations ids on the configuration path of Artifacter. It returns a string array containing each form configuration ID (file name without extension).

Get Form Configuration

Resource | Method | Request ContentType | Response ContentType -------- | ------ | --------------------- | ----------------------- /forms/:id | GET | application/x-www-form-urlencoded | application/json

Retrieves the contents of a identified form configuration file on Artifacter as a json string.

Request Artifact Generation

Resource | Method | Request ContentType | Response ContentType -------- | ------ | --------------------- | ----------------------- /generatedArtifacts | POST | application/json | application/json

Requests an artifact generation and returns an uuid to retrieve the generated artifacts. The RESTful API responds with the location of the created resource (generated artifact) in the Location header.

Retrieve generated artifacts

Resource | Method | Request ContentType | Response ContentType -------- | ------ | --------------------- | ----------------------- /generatedArtifacts/:uuid | GET | application/x-www-form-urlencoded | application/zip

Retrieves a generated artifact, once is retrieved it is deleted from the temporary folder, any subsequent try to get the same artifact will result in a 404 status code.

How do I handle all the Configuration? - Artifacter's Core Configuration

Check out the @artifacter/core README