Versions Compared

Version Old Version 5 New Version 6
Changes made by

Bart Friederichs

Bart Friederichs

Saved on

Key

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

...

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

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

Response

HTTP204 is successful

Possible Errors

HTTP400 when request was invalid

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

Status

Status
colourGreen
titleimplemented

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 when successful

Possible errors

HTTP400 when request was invalid

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

HTTP404 with no body when mapping does not exist

HTTP409 when cabinet not in correct mode, or when the mapped resource was invalid (which can only be solved by a valid upload, see above).

Status

Status
colourRed
titlepending