Mapping

These REST calls are used in the 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	`{ «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	`{ "exceldata": «base64 encoded xlsx file data» }`
Response	HTTP204 when successful
Possible Errors	HTTP400 when request was invalid `{ "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	`color` is optional. When no color is chosen, it defaults to `red`.
Response	HTTP204 when successful
Possible errors	HTTP400 when request was invalid HTTP404 with no body when mapping for barcode does not exist HTTP409 when mapping was invalid

TBWB Smart Products Public