Versions Compared

Version Old Version 2 New Version Current
Changes made by

Bart Friederichs

Bart Friederichs

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

These REST calls are used in the data mapping feature, where a user can upload mapping info and use that info to switch on light.

URL

http://<<ip address>>/rest/mapping

Method

GET

Description

Receive the current existing mapping. Returns an empty object when no mapping is set.

Response

Code Block
{
  «barcode»: { 
    "plank": «plank», 
    "section": «section»,
    ... 
  },
  ...
}

URL

http://<<ip address>>/rest/mapping

Method

POST

Description

Upload a new XLSX file to register a mapping. It will read the columns barcode, description (optional), plank and section from the first sheet. If the mandatory columns are not available, an HTTP400 error will occur. Column headers are expected on row 1, starting from column A.

On upload, all existing data will be erased and the new data is loaded.

Request

Base64 encoded XLSX data.

The Content-Type header must be application/octet-stream

Code Block
{
  "exceldata": «base64 encoded xlsx file data»
}

Response

HTTP204 when successful

Possible Errors

HTTP400 when request was invalid

Code Block
{
  "message": «human readable error»
}

URL

http://<<ip address>>/rest/mapping/«barcode»

Method

PUT

Description

Set the light that corresponds to the barcode in the previously uploaded mapping. This behaves the same as the rest/plank/«plank»/section/«section»/side/front call. The cabinet needs to be in section mode for this to work correctly.

Request

Code Block
{
  "value": «valuetodisplay»,
  ["color": "red|green|orange|blue|pink|cyan"]
}

color is optional. When no color is chosen, it defaults to red.

Response

HTTP204

is

when successful

Possible

Errors

errors

HTTP406

HTTP400 when

invalid Content-Type header was given.

Status

StatuscolourRedtitlepending

request was invalid

Code Block
{
  "message": «human readable error»
}

HTTP404 with no body when mapping for barcode does not exist

HTTP409 when mapping was invalid