caMicroscope API Guide (Draft)

Contents of this Page

/ImageLoader

The /ImageLoader resource is a Node application that extracts image metadata (such as width and height of the image) from the existing whole slide image and stores it in a Mongo database.

HTTP Verb	QueryEndpoint	Query Parameters(Input)	Output(Description)
POST	/submitImage	case_id, File_location, subject_id	{“status”: “Success”} on success

Example of /ImageLoader

example here

/uAIMDataLoader

Node application that converts masks (what kind of masks? Aperio? Binary masks? which conversion?) to GeoJSON objects and stores them in a Mongo database. Need input, output, and command for each.

HTTP Verb

QueryEndpoint

Query Parameters(Input)

Output(Description)

POST

/submitMask

Case_id,

Execution_id,

Height,

Width,

X,

Y,

Type(optional)

{“jobId”: 12}

GET

/job/:id

None

{“status”:”incomplete”}

Example of /uAIMDataLoader

Need definitions of each query parameter. Need examples.

/ImageData

Bindaas

(Add more explanation here)

HTTP Verb	QueryEndpoint	Query Parameters(Input)	Output(Description)	Questions
GET	/fileLocation	case_id	N/A	Need explanation
	/mpp	case_id	N/A	Need explanation
	/metadata	case_id	N/A	Need explanation
	/md5	case_id	N/A	Need explanation
POST	/json	N/A	N/A	What are you posting? What is in the mongo database about this image?

Example of /ImageData

Need explanation of reason to use each item above.

POST http://www.example.com/customers
POST http://www.example.com/customers/12345/orders

/MarkupData

Bindaas

HTTP Verb

QueryEndpoint

Query Parameters(Input)

Output(Description)

Questions

GET

/multipleMarkups

Case_id,

x1,y1,x2,y2,footprint,algorithms

GeoJSON

Need explanation

x1,y1,x2,y2 are different than what is in caMicroscope demo (had x, y, width, height)

N/A

/executionIds

case_id

List of execution IDs available for case

Need explanation. How would one get these execution IDs for a specific slide? Need to explain the difference between a caseID and an executionID–also any of the query modifiers.

Examples of /MarkupData

/uAIMTemplates

Schema: https://github.com/joshfire/jsonform

HTTP Verb	QueryEndpoint	Query Parameters(Input)	Output(Description)
GET	/template	id?	Jsonform template
POST	/json	N/A	N/A

Examples of /uAIMTemplates

Examples here

/Tasks

Firebase/Kue???

HTTP Verb	QueryEndpoint	Query Parameters(Input)	Output(Description)
POST	/task	N/A	N/A
GET	/task	task_id	N/A

Examples of /Tasks