Investigation

From ToxBank API Wiki
(Difference between revisions)
Jump to: navigation, search
m
Line 13: Line 13:
 
= Retrieve Metadata of a single Study=
 
= Retrieve Metadata of a single Study=
 
{{:API_Study:RetrieveMetadata}}
 
{{:API_Study:RetrieveMetadata}}
 +
 +
==
 +
 +
TBD
 +
 +
Assay:
 +
 +
/study/{id}/assay/{id}/protocol
 +
list of protocols
 +
 +
/study/{id}/assay/{id}/data
 +
list of data links

Revision as of 16:37, 15 September 2011

Investigation


Contents

Retrieve the List of Studies

Description Get a list of studies
Resource Investigation
Method GET
URI /investigation/{id}/study
Parameters
Header Parameters
Media Type (input) none
Results List of studies
Media Type (output) text/uri-list
Status code 200,400,401,402,403


Upload a new Study

Description Add/update studies, assays or data to an investigation
Resource Investigation
Method PUT
URI /investigation/{id}
Parameters optional params:
  • allowReadByUser: one or multiple userservice-URIs (User)
  • allowReadByGroup: one or multiple userservice-URIs (Organisations, Projects)
  • summarySearchable: true/false (default is false)
  • published: true/false (default is false)

required params (when upload not in isa-tab format):

  • type: one of noData/unformattedData/ftpData
  • title: string
  • abstract: string
  • owningOrg: one userservice-URI (Organisations)
  • owningPro: one or multiple userservice-URIs (Projects)
  • authors: one or multiple userservice-URIs (User)
  • keywords: one or multiple owl-URIs
  • ftpFile: one or multiple filenames (only for type ftpData)
Header Parameters subjectid:SECURITY-TOKEN
Media Type (input) multipart/form-data
Results Task URI
Media Type (output) text/uri-list
Status code 202, 400, 401, 423

Individual ISA-TAB files (text/tab-separated-values) or zip archives of study, assay and data files can be posted as form data to add files to an existing investigation. Investigations without ISA-TAB formated data can be edited by parameters and data files posted as form data replace existing data.

Retrieve a single Study

Description Get a study, assay, data representation
Resource Investigation
Method GET
URI /investigation/{id}/isatab/{filename}
Parameters
Header Parameters subjectid:SECURITY-TOKEN
Media Type (input)
Results Study, assay, data representation in ISA-TAB format
Media Type (output) text/tab-separated-values
Status code 200, 400, 401, 404


Retrieve Metadata of a single Study

Description Retrieves study metadata
Resource Investigation
Method GET
URI /study/{id}/metadata
Parameters TBD
Header Parameters
Media Type (input) none
Results Study metadata in supported Media Type formats
Media Type (output) text/uri-list, RDF, JSON, XML
Status code 200,400,401,402,403


==

TBD

Assay:

/study/{id}/assay/{id}/protocol list of protocols

/study/{id}/assay/{id}/data list of data links

Personal tools