caTissue REST API
The purpose of this document is to explain the caTissue REST API to be used for communicating with other applications. caTissue expose REST API for performing add/update/search operation on Specimen, SpecimenCollectionGroup and creating aliquots/derivatives for the parent specimen.
Common Characteristics of REST Resources
...
Response
| Status | Response |
|---|---|
| 201 | application/json {"id":1,"label":"testLabel","className":"Tissue","type":"Not Specified","barcode":"12345","createdDate":"Jul 31, 2013 11:16:14 AM","availableQuantity":2.0,"activityStatus":"Active","isToPrintLabel":false} |
| 400 | {"error": <any application specific error>} |
| 403 | {"error":"User is not authorized to create the specimens"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
...
Response
| Status | Response |
|---|---|
| 201 | application/json {"id":1,"label":"testLabel","className":"Tissue","type":"Not Specified","barcode":"12345","createdDate":"Jul 31, 2013 11:16:14 AM","availableQuantity":2.0,"activityStatus":"Closed","isToPrintLabel":false} |
| 400 | {"error": <any application specific error>} |
| 403 | {"error":"User is not authorized to create the specimens"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
...
Response
| Status | Response |
|---|---|
| 200 | application/json {"id":1,"label":"testLabel","className":"Tissue","type":"Not Specified","barcode":"12345","createdDate":"Jul 31, 2013 11:16:14 AM","availableQuantity":2.0,"activityStatus":"Active","isToPrintLabel":false} |
| 400 | {"error": <any application specific error>} |
| 404 | {"error" : "No Specimen found with given label/barcode <label/barcode>"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
...
Response
| Status | Response |
|---|---|
| 200 | application/json |
| 400 | {"error": <any application specific error>} |
| 403 | {"error":"User doesn't have specimen processing privileges"} |
| 404 | {"error":"Parent with label/barcode <label/barcode> doesn't exist |
| 500 | {"error" : "Something went wrong. please try again later"} |
...
Response
| Status | Response |
|---|---|
| 200 | application/json |
| 400 | {"error": <any application specific error>} |
| 403 | {"error":"User doesn't have specimen processing privileges"} |
| 404 | {"error" : "Parent with given label/barcode <label/barcode> doesn't exist"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
Specimen Collection Group Resource
catissuecore/rest/groupsspecimenCollectionGroups
Creates the specimen collection group.
...
| Method | URL |
|---|---|
| POST | catissuecore/rest/groups specimenCollectionGroups |
| accept | application/json |
Response
| Status | Response |
|---|---|
| 200 | application/json |
| 400 | {"error": <any application specific error>} |
| 403 | {"error":"User doesn't have privileges to create Specimen collection group"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
catissuecore/rest/groupsspecimenCollectionGroups
updates the specimen collection group.
...
| Method | URL |
|---|---|
| PUT | catissuecore/rest/groups specimenCollectionGroups |
| accept | application/json |
Response
| Status | Response |
|---|---|
| 200 | application/json |
| 400 | {"error": <any application specific error>} |
| 403 | {"error":"User doesn't have privileges on this Specimen collection group"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
catissuecore/rest/groupsspecimenCollectionGroups
Retrieves the specimen collection group with the name.
...
| Method | URL |
|---|---|
| GET | catissuecore/rest/groups specimenCollectionGroups |
| parameters | title: the specimen collection group will be searched on the basis of title. |
...
Response
| Status | Response |
|---|---|
| 200 | application/json |
| 400 | {"error": <any application specific error>} |
| 404 | {"error" : "No group found with title '<title-name>'"} |
| 500 | {"error" : "Something went wrong. please try again later"} |
...