Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

openspecimen/rest/ng/collection-protocols/{id}

or

openspecimen/rest/ng/collection-protocols/title={title}

or

openspecimen/rest/ng/collection-protocols/shortTitle={shortTitle}


Use this resource to get collection protocol. This API returns the collection protocol present in the openSpecimen application of given name and idid, title and short title

Below are the attributes which need to be sent in the URL:

Parameter
Details
idCP Collection protocol id to fetch the CPcollection protocol
titleCP Collection protocol title to fetch the CPcollection protocol
shortTitleCP Collection protocol shortTitle to fetch the CPcollection protocol


http[s]:<host>:<port>/openspecimen/rest/ng/collection-protocols/{id}

or

http[s]:<host>:<port>/openspecimen/rest/ng/collection-protocols/title={title}

or

http[s]:<host>:<port>/openspecimen/rest/ng/collection-protocols/shortTitle={shortTitle}


Use this URL to get collection protocol by an id in openSpecimen application

Result:

The response of this request will contains the details of the collection protocol.

Below is the example of the get collection protocol:

URL

http://<host>:<port>/openspecimen/rest/ng/collection-protocols/1

or

http://<host>:<port>/openspecimen/rest/ng/collection-protocols/title= skinCancerStudy 

or

http://<host>:<port>/openspecimen/rest/ng/collection-protocols/shortTitle=SCS_CPcollection protocol

MethodGET
Requestapplication/json

Response

{
id1
title"skinCancerStudy"
shortTitle"SCS_CPcollection protocol"
cpTypecollection protocolType"Parent"
startDatenull
endDate"1995-10-01"
activityStatus"Active"
labelFormatnull
derivedLabelFormatnull
aliquotLabelFormatnull
ppIdFormat" "
investigator
{
loginName"admin@admin.com"
domainName"catissue"
}
}

 

Error Cases :

code
Applies to
Status Message
200All resourcesCollection protocol got successfully
401All requestsAuthorization failed, user doesn’t have authority
500All requestsInternal server error, encountered server error while performing operations