...
Action | Intended User | URI | Method | Request Params | Request Body | Response Body | |
---|---|---|---|---|---|---|---|
create or update Research Project | Synapse User | /researchProject | POST | ResearchProject | ResearchProject | ||
get ResearchProject for update | creator | /accessRequirement/{id}/researchProjectForUpdate | GET | ResearchProject | |||
5 | |||||||
6 | |||||||
7 | asking the server for a suitable request object to start with | creator | /accessRequirement/{id}/dataAccessRequestForUpdate | GET | RequestInterface | ||
create or update Request | Synapse User | /dataAccessRequest | POST | RequestInterface | RequestInterface | ||
9 | submit a Request | creator, | /dataAccessRequest/{id}/submission | POST | etag | SubmissionStatus | |
11 | cancel a Submission | requestor, | /dataAccessSubmission/{id}/cancellation | PUT | SubmissionStatus | ||
12 | update a Submission | ACT | /dataAccessSubmission/{id} | PUT | SubmissionStateChangeRequest | SubmissionStatus | |
13 | retrieve a list of Submission | ACT | /accessRequirement/{id}/submissions | GET | nextPageToken, order (SubmissionOrder), filter (SubmissionState), asc | SubmissionPage | |
/ | RestrictionInfo | ||||||
retrieve restriction information | Synapse user | /restrictionInformation | POST | RestrictionInformationRequest | RestrictionInformationResponse | ||
16 | retrieve access requirement status | Synapse user | /accessRequirement/{id}/status | GET | AccessRequirementStatus | ||
17 | retrieve info about open submissions | ACT | /dataAccessSubmission/openSubmissions | GET | nextPageToken | OpenSubmissionPage | |
BatchAccessApprovalRequest |
---|
List<String> userIds String accessRequirementId |
...
OpenSubmission |
---|
String accessRequirementId |
Long numberOfOpenSubmissions |
ACTAccessRequirementStatus implements AccessRequirementStatus |
---|
String accessRequirementId |
Boolean isApproved |
SubmissionStatus current submissionStatus |
SubmissionStatus |
---|
String submittedBy |
String submissionId |
SubmissionState state |
String rejectedReason |
Long reviewedOn |
...
SubmissionStateChangeRequest | |
---|---|
String submissionId | |
SubmissionState newState (only APPROVED and REJECTED are valid) | |
String rejectedReason | RestrictionInfo
RestrictionInformationRequest |
---|
String objectId |
RestrictableObjectType objectType |
RestrictionInformationResponse |
---|
RestrictionLevel restrictionLevel (OPEN, RESTRICTED_BY_TERMS_OF_USE, CONTROLLED_BY_ACT) |
boolean hasUnmet |
...
- Making AccessRequirement version-able.
- An access approval grants a user access to a specific access requirement version.
- On download, if a user have access approval for one version any version of the access requirement, the user meets the conditions specified by that access requirement.
- A new API need to be added to retrieve a version of an access requirement.
- Retrieving restriction information API needs to be generic (taking an ID and subject type instead of being specific for entity only)
- A submission points to a particular access requirement version.
- Retrieving Access Requirement Status always include information about whether or not a user have met the conditions specified by the access requirement regardless of version.
...