Create Aliquots for specified specimen
Use of this REST API is to create aliquots for given specimen.
You can create aliquots through POST URL http://<host>:<port>/catissuecore/rest/ng/specimens/{specimenId}/aliquots
Parameter Details :
The aliquot creation API takes the following parameters in json request :
Parameter | Details | ||||||
|---|---|---|---|---|---|---|---|
| noOfAliquots | Number of aliquots to create from specimen | ||||||
| quantityPerAliquot | Specimen quantity to create each aliquot | ||||||
| Positions | List of positions to store created aliquot. List Contains
|
API Example :
| Method | URL |
|---|---|
| POST | http://<host>:<port>/catissuecore/rest/ng/specimens/{idspecimenId}/aliquots |
| Request | application/json |
| json | { "count":1, "quantityPerAliquot":2, "positions":[ {"containerName":"cont1","position1":"X","position2":"Y"}, {"containerName":"cont2","position1":"X","position2":"Y"} ], "specimenId":1 } |
| Response | { [ { "id":1, "tissueSite" : "S1", "tissueSide" : "Tissue", "pathologicalStatus" : "Not Specified", "lineage": "Aliquot", "initialQuantity": 2, "availableQuantity": 2, "specimenClass": "Tissue", "specimenType": "Fresh Tissue", "concentrationInMicrogramPerMicroliter": " 1", "label": "29_1", "activityStatus": "Active", "isAvailable": "true", "barcode": " 1111", "comment": null, "createdOn": "04-04-2014 ", "collectionStatus": " Collected", "specimenCollectionGroup": {"id": 1, "name": "TestSCG", ...}, "biohazardCollection": {"id":1 , "name": "RadioActive" , "type" : "RadioActive"}, "externalIdentifierCollection": {"id": 1, "name": "", "value": ""} },
{ "id":2, "tissueSite" : "S1", "tissueSide" : "Tissue", "pathologicalStatus" : "Not Specified", "lineage": "Aliquot", "initialQuantity": 2, "availableQuantity": 2, "specimenClass": "Tissue", "specimenType": "Fresh Tissue", "concentrationInMicrogramPerMicroliter": " 1", "label": "29_1", "activityStatus": "Active", "isAvailable": "true", "barcode": " 1111", "comment": null, "createdOn": "04-04-2014 ", "collectionStatus": " Collected", "specimenCollectionGroup": {"id": 1, "name": "TestSCG", ...}, "biohazardCollection": {"id":1 , "name": "RadioActive" , "type" : "RadioActive"}, "externalIdentifierCollection": {"id": 1, "name": "", "value": ""} } ] |
Error Cases
Response Status :
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | Aliquots has been created successfully |
| 400 | All requests | Invalid parameters, like count count should be greater than 0 |
| 401 | All requests | Authorization failed, User doesn’t have Authority to create Aliquot |
| 500 | All requests | Internal server error, Encountered server error while performing operations |