openspecimen/rest/ng/collection-protocol-registrations/{cprId}/consents
Use this resource to save consent-tier response for participant registration in the OpenSpecimen applicationparticipant consent responses. Use HTTP POST PUT method to call this API by passing the below details in JSON format.
Below are the attributes which need to be sent in the request body:
| |
|---|
| cprId[mandatory] | Mandatory. Collection Protocol Registration Id |
| consentDocumentUrl | identifier of consent-tier to update |
| consentSignatureDate | consent-tier statement |
| consentTierResponsesID |
| consentSignatureDate | Consent signature date |
| responses |
| parameter | detail |
|---|
| code | Consent statement code (Either this or below statement) | | statement | Consent tier statement defined in CPstatement (Either this or above code) | | response | Patient response. Response should be one of the below: Yes, No, Not Specified, Withdrawn, None |
|
| witness |
| Parameter | Details |
|---|
| emailAddress | Email address of the witness | | loginName | Login name of the witness |
|
http[s]:<host>:<port>/openspecimen/rest/ng/collection-protocols/{cpId}/consents
Use this URL to update consent-tier for Collection Protocol in the OpenSpecimen application.
Result:
The response of this request will contains the details of the updated consent-tier
Below is the example of the update consent-tierGiven below is an example request/response exchanged to update participant consents:
| URL | http[s]://<host>:<port>/openspecimen/rest/ng/collection-protocol-registrations/48878/consents |
| Method | PUT |
| Request | application/json |
| json |
| Code Block |
|---|
| {
"consentSignatureDate": "2022-04-20",
"witness": {
"id": 1,
"emailAddress:": "admin@krishagni.com"
},
"comments": "Consent to diecollect specimens",
"responses": [
{
"code": "CS1",
"response": "Yes"
},
{
"code": "CS2",
"response": "No"
}
]
} |
|
Response | opCommentsnull,
"cprId": null,
"cpId": null,
"cpShortTitle": "kaustubh_cp""Lung Cancer",
"ppid": "PPID_KW_001",
"consentSignatureDate": 1650412800000,
"witness": {
"id": 1,
"type": "SUPER",
"firstName": "Admin",
"lastName": "Admin",
"loginName": "admin@krishagni.com",
"domain": "openspecimen",
"emailAddress": "admin@krishagni.com",
"instituteId": 1,
"instituteName": "A1 - For Demo Users",
"admin": true,
"instituteAdmin": false,
"phoneNumber": "",
"manageForms": true,
"manageWfs": true,
"cpCount": 0,
"activityStatus": "Locked"
},
"comments": "Consent to |
collect specimens",
"responses": [
{
"code": "CS1",
"response": "Yes"
},
{
"code": "CS2",
"response": "No"
}
] |
|