Proposed Decapod Dewarp Server Architecture

Proposed Decapod Dewarp Server Architecture

Resources

Request Type

Response / Action

Status Code

Request Type

Response / Action

Status Code

GET

Redirects to the start page for the Decapod Dewarp user interface.

Success: 301

DELETE, POST, PUT

N/A

Error: 405

GET

Returns the status of the uploaded zip file that contains the images for being dewarped
At success:

{ numOfCaptures: # }

At Error:

{ error_code: "BAD_ZIP" msg: "A bad uploaded zip file" }

Success: 200, Error: 500 or 404 if the unpacked captures dir does not exist

PUT

Upload the zip file of captures to be dewarped. Returns the same output as GET request

Success: 200, Error: 500

DELETE

Removes all of the capture files

Success: 204, Error: 500 or 409 if a dewarping is in progress

POST

N/A

Error: 405

GET

Returns the status of the upload zip file that contains the calibration data
At Error:

{ error_code: "BAD_ZIP" msg: "A bad uploaded zip file" }

Success: 200, Error: 500 or 404 if the unpacked calibration dir does not exist

PUT

Upload the zip file of the calibration data. Returns the same output as GET request

Success: 200, Error: 500

DELETE

Removes all of the calibration data

Success: 204, Error: 500

POST

N/A

Error: 405

PUT

Launch the color picker window

Success: 200, Error: 500

GET, POST, DELETE

N/A

Error: 405

GET

Returns the status of the dewarping.
If the dewarping is in progress,

{ status: "in progress", currentCapture: #, numOfCaptures: # }

If the dewarping completes,

{ status: "complete", url: "http://localhost:8082/data/dewarped.zip" }

At error,

{ status: "error" }

Success: 200, Error: 500

PUT

Trigger the dewarp action

Success: 202, Error: 409

DELETE

Removes all dewarp data

Success: 204, Error: 409

POST

N/A

Error: 405