See Service API Design for the rationale and design details for this api.
See Developer Bootstrap#DeveloperBootstrap-ServiceDevelopment for instructions on how to run a local instance of this service.
The primary request and response encoding for the service is JSON. Here's a handy tool to make a blob of JSON more readable: http://jsonformatter.curiousconcept.com/
In responses from the service, dates are serialized as long integers expressing epoch time - the number of seconds elapsed since midnight Coordinated Universal Time (UTC) of January 1, 1970, not counting leap seconds. Here's a handy tool to convert from epoch time to human readable dates: http://www.epochconverter.com/
In requests to the service, dates can be serialized either as long integers expressing epoch time or human readable dates in http://www.ietf.org/rfc/rfc3339.txt format such as '2011-01-31' or '2011-01-31T22:00:00'
Eventually these services will be HTTPS only and disallow HTTP. Users will pass something like ?access_token=... as a query parameter for every request to the service
Right now only a subset of query functionality is supported
SELECT * FROM <data type> [LIMIT <#>] [OFFSET <#>] |
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/query?query=select+*+from+dataset+limit+3+offset+1' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results": [ { "Disease": ["Cancer"], "Institution": ["Asian Cancer Research Group, Inc., (ACRG)"], "Internal Name": ["ACRG_gastric"], "Number of Samples": [2000], "Posting Restriction": ["unspecified"], "Species": ["Human"], "Tissue/Tumor": ["Stomach"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/gastric_cancer_acrg.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/gastric_cancer_acrg.txt"], "creationDate": 1298945377085, "creator": "Asian Cancer Research Group, Inc., (ACRG)", "db_id": [1], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "name": "Gastric Cancer ACRG", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/gastric_cancer_acrg.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/gastric_cancer_acrg.txt"], "version": "0.0.1" }, { "Disease": ["Cancer"], "Institution": ["Asian Cancer Research Group, Inc., (ACRG)"], "Internal Name": ["ACRG_lung"], "Number of Samples": [2000], "Posting Restriction": ["unspecified"], "Species": ["Human"], "Tissue/Tumor": ["Lung"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/lung_cancer_acrg.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/lung_cancer_acrg.txt"], "creationDate": 1298945379140, "creator": "Asian Cancer Research Group, Inc., (ACRG)", "db_id": [2], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYGAw", "name": "Lung Cancer ACRG", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/lung_cancer_acrg.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/lung_cancer_acrg.txt"], "version": "0.0.1" }, { "Disease": ["Cancer"], "Institution": ["Fred Hutchinson Cancer Research Center /SKCCC at Johns Hopkins"], "Internal Name": ["AML-Ped_TARGET"], "Number of Samples": [200], "Posting Restriction": ["Link to data source"], "Species": ["Human"], "Tissue/Tumor": ["Blood"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/pediatric_aml_target.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/pediatric_aml_target.txt"], "creationDate": 1298945379712, "creator": "Soheil Meshinchi/ Bob Arceci", "db_id": [3], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYKww", "name": "Pediatric AML TARGET", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/pediatric_aml_target.txt"], "releaseDate": null, "status": "Pending", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/pediatric_aml_target.txt"], "version": "0.0.1" } ], "totalNumberOfResults": 114 } |
Right now only a subset of query functionality is supported
SELECT * FROM <data type> ORDER BY "<field name>" [ASC|DESC] [LIMIT <#>] [OFFSET #] |
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/query?query=select+*+from+dataset+order+by+"name"+limit+3+offset+1' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results": [ { "Disease": ["Cancer"], "Institution": ["Sage Bionetworks"], "Internal Name": ["Nonresponders_AML"], "Number of Samples": [300], "Posting Restriction": ["unspecified"], "Species": ["Human"], "Tissue/Tumor": ["Blood"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/aml_nonresponders_cohort.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/aml_nonresponders_cohort.txt"], "creationDate": 1298945404356, "creator": "Stephen Friend", "db_id": [74], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYoAsM", "name": "AML Nonresponders Cohort", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/aml_nonresponders_cohort.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/aml_nonresponders_cohort.txt"], "version": "0.0.1" }, { "Disease": ["Cancer"], "Institution": ["TCGA"], "Internal Name": ["TCGA_AML"], "Number of Samples": [500], "Posting Restriction": ["Embargo"], "Species": ["Human"], "Tissue/Tumor": ["Blood"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/aml_tcga.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/aml_tcga.txt"], "creationDate": 1298945411055, "creator": "TCGA", "db_id": [96], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYzA4M", "name": "AML TCGA", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/aml_tcga.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/aml_tcga.txt"], "version": "0.0.1" }, { "Disease": ["Asthma"], "Institution": ["Imperial College London"], "Internal Name": ["Cookson_LCLs"], "Number of Samples": [404], "Posting Restriction": ["unspecified"], "Species": ["Human"], "Tissue/Tumor": ["Lymphoblastoid Cell Line"], "Type": ["Other"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/asthma_human_lymphoblastoid_cell_lines.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/asthma_human_lymphoblastoid_cell_lines.txt"], "creationDate": 1298945389061, "creator": "Cookson", "db_id": [25], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQY5QMM", "name": "Asthma Human Lymphoblastoid Cell Lines", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/asthma_human_lymphoblastoid_cell_lines.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/asthma_human_lymphoblastoid_cell_lines.txt"], "version": "0.0.1" } ], "totalNumberOfResults": 114 } |
Right now only a subset of query functionality is supported
SELECT * FROM <data type> WHERE "<field name>" == "<value>" [LIMIT <#>] [OFFSET #] |
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/query?query=select+*+from+dataset+where+name+==+"Human Liver Cohort"' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results": [{ "Disease": ["CVD"], "Institution": ["Vanderbilt University/ University of Pittsburg/ StJudes Hospital"], "Internal Name": ["Deliver"], "Number of Samples": [517], "Posting Restriction": ["Link to data source"], "Species": ["Human"], "Tissue/Tumor": ["Liver"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/human_liver_cohort.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/human_liver_cohort.txt"], "creationDate": 1298945390430, "creator": "Fred Guengrich/Steve Strom/ Erin Schuetz", "db_id": [29], "description": null, "hasClinicalData": true, "hasExpressionData": true, "hasGeneticData": true, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM", "name": "Human Liver Cohort", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/human_liver_cohort.txt"], "releaseDate": null, "status": "Current", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/human_liver_cohort.txt"], "version": "0.0.1" }], "totalNumberOfResults": 114 } |
Right now only a subset of query functionality is supported
SELECT * FROM <data type> WHERE "<field name>" == "<value>" [LIMIT <#>] [OFFSET #] |
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/query?query=select+*+from+dataset+where+"Species"+==+"Human"+limit+3+offset+1' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results": [ { "Disease": ["Cancer"], "Institution": ["Asian Cancer Research Group, Inc., (ACRG)"], "Internal Name": ["ACRG_gastric"], "Number of Samples": [2000], "Posting Restriction": ["unspecified"], "Species": ["Human"], "Tissue/Tumor": ["Stomach"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/gastric_cancer_acrg.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/gastric_cancer_acrg.txt"], "creationDate": 1298945377085, "creator": "Asian Cancer Research Group, Inc., (ACRG)", "db_id": [1], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "name": "Gastric Cancer ACRG", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/gastric_cancer_acrg.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/gastric_cancer_acrg.txt"], "version": "0.0.1" }, { "Disease": ["Cancer"], "Institution": ["Asian Cancer Research Group, Inc., (ACRG)"], "Internal Name": ["ACRG_lung"], "Number of Samples": [2000], "Posting Restriction": ["unspecified"], "Species": ["Human"], "Tissue/Tumor": ["Lung"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/lung_cancer_acrg.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/lung_cancer_acrg.txt"], "creationDate": 1298945379140, "creator": "Asian Cancer Research Group, Inc., (ACRG)", "db_id": [2], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYGAw", "name": "Lung Cancer ACRG", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/lung_cancer_acrg.txt"], "releaseDate": null, "status": "Future", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/lung_cancer_acrg.txt"], "version": "0.0.1" }, { "Disease": ["Cancer"], "Institution": ["Fred Hutchinson Cancer Research Center /SKCCC at Johns Hopkins"], "Internal Name": ["AML-Ped_TARGET"], "Number of Samples": [200], "Posting Restriction": ["Link to data source"], "Species": ["Human"], "Tissue/Tumor": ["Blood"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/pediatric_aml_target.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/pediatric_aml_target.txt"], "creationDate": 1298945379712, "creator": "Soheil Meshinchi/ Bob Arceci", "db_id": [3], "description": null, "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYKww", "name": "Pediatric AML TARGET", "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/pediatric_aml_target.txt"], "releaseDate": null, "status": "Pending", "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/pediatric_aml_target.txt"], "version": "0.0.1" } ], "totalNumberOfResults": 114 } |
Right now only a subset of query functionality is supported
SELECT * FROM layer WHERE dataset.id == <datasetId> [LIMIT <#>] [OFFSET <#>] |
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/query?query=select+*+from+layer+where+dataset.id+==+"agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM"' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results": [ { "creationDate": 1298945436418, "description": "", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "name": "expression data", "platform": null, "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "E", "version": "0.0.1" }, { "creationDate": 1298945441154, "description": "", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "name": "genetic data", "platform": null, "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "G", "version": "0.0.1" }, { "creationDate": 1298945433633, "description": "", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "name": "clinical data", "platform": null, "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "C", "version": "0.0.1" } ], "totalNumberOfResults": 3 } |
Right now only a subset of query functionality is supported
SELECT * FROM layer WHERE dataset.id == <datasetId> ORDER BY "<field name>" [ASC|DESC] [LIMIT <#>] [OFFSET <#>] |
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/query?query=select+*+from+layer+where+dataset.id+==+"agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM"+ORDER+BY+"type"' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results": [ { "creationDate": 1298945433633, "description": "", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "name": "clinical data", "platform": null, "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "C", "version": "0.0.1" }, { "creationDate": 1298945436418, "description": "", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "name": "expression data", "platform": null, "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "E", "version": "0.0.1" }, { "creationDate": 1298945441154, "description": "", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "name": "genetic data", "platform": null, "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "G", "version": "0.0.1" } ], "totalNumberOfResults": 3 } |
This is just a 'hello world' type request that you can make to ensure that the service is running.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/test' |
Response
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 Content-Language: en-US Pragma: no-cache Cache-Control: no-cache, no-store, max-age=0 Expires: Thu, 01 Jan 1970 00:00:00 GMT Transfer-Encoding: chunked Server: Jetty(6.1.x) {"hello": "REST for Datasets rocks"} |
Optional Parameters
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset?sort=name&limit=3' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "paging": {"next": "/repo/v1/dataset?offset=4&limit=3&sort=name&ascending=true"}, "results": [ { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYoAsM/annotations", "creationDate": 1298945404356, "creator": "Stephen Friend", "description": null, "etag": "463407100", "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYoAsM", "layer": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYoAsM/layer", "name": "AML Nonresponders Cohort", "releaseDate": null, "status": "Future", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYoAsM", "version": "0.0.1" }, { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYzA4M/annotations", "creationDate": 1298945411055, "creator": "TCGA", "description": null, "etag": "-1044640987", "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYzA4M", "layer": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYzA4M/layer", "name": "AML TCGA", "releaseDate": null, "status": "Future", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYzA4M", "version": "0.0.1" }, { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQY5QMM/annotations", "creationDate": 1298945389061, "creator": "Cookson", "description": null, "etag": "1355965204", "hasClinicalData": false, "hasExpressionData": false, "hasGeneticData": false, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQY5QMM", "layer": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQY5QMM/layer", "name": "Asthma Human Lymphoblastoid Cell Lines", "releaseDate": null, "status": "Future", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQY5QMM", "version": "0.0.1" } ], "totalNumberOfResults": 114 } |
This returns the primary fields of a dataset and links to get additional info.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: -1606583262 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/annotations", "creationDate": 1298945390430, "creator": "Fred Guengrich/Steve Strom/ Erin Schuetz", "description": null, "etag": "-1606583262", "hasClinicalData": true, "hasExpressionData": true, "hasGeneticData": true, "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM", "layer": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer", "name": "Human Liver Cohort", "releaseDate": null, "status": "Current", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM", "version": "0.0.1" } |
This returns the annotations for a dataset.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/annotations' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 413002292 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "creationDate": null, "dateAnnotations": {}, "doubleAnnotations": {}, "etag": "413002292", "id": "agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM", "longAnnotations": { "Number of Samples": [517], "db_id": [29] }, "stringAnnotations": { "Disease": ["CVD"], "Institution": ["Vanderbilt University/ University of Pittsburg/ StJudes Hospital"], "Internal Name": ["Deliver"], "Posting Restriction": ["Link to data source"], "Species": ["Human"], "Tissue/Tumor": ["Liver"], "Type": ["GCD"], "abstract_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/abstract_files/human_liver_cohort.txt"], "citation_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/citation_files/human_liver_cohort.txt"], "readme_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/readme_files/human_liver_cohort.txt"], "user_agreement_file_path": ["/srv/www/htdocs/Foswiki/downloads/data/v2/user_agreement_files/human_liver_cohort.txt"] }, "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/annotations" } |
This returns the primary fields for all the layers of a dataset.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "paging": {}, "results": [ { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/annotations", "creationDate": 1298945436418, "description": "", "etag": "1368934515", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "locations": [ "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/sageLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/awsEBSLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/locations", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/awsS3Location" ], "name": "expression data", "platform": null, "preview": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/preview", "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "E", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "version": "0.0.1" }, { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/annotations", "creationDate": 1298945441154, "description": "", "etag": "-1673543886", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "locations": [ "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/sageLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/awsS3Location", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/awsEBSLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/locations" ], "name": "genetic data", "platform": null, "preview": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/preview", "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "G", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "version": "0.0.1" }, { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/annotations", "creationDate": 1298945433633, "description": "", "etag": "-566282579", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "locations": [ "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsEBSLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/locations", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsS3Location", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/sageLocation" ], "name": "clinical data", "platform": null, "preview": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/preview", "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "C", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "version": "0.0.1" } ], "totalNumberOfResults": 3 } |
This returns the metadata for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 1368934515 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/annotations", "creationDate": 1298945436418, "description": "", "etag": "1368934515", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "locations": [ "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/sageLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/awsEBSLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/locations", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/awsS3Location" ], "name": "expression data", "platform": null, "preview": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/preview", "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "E", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "version": "0.0.1" } |
This returns the annotations for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/annotations' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 923521 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "creationDate": null, "dateAnnotations": {}, "doubleAnnotations": {}, "etag": "923521", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "longAnnotations": {}, "stringAnnotations": {}, "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/annotations" } |
This returns the preview data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/preview' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 945969657 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "etag": "945969657", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM", "preview": "expression data preview", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/preview" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/sageLocation' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "path": "/Shares/external-data/DAT_030__human_liver_cohort", "type": "sage" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/awsEBSLocation' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "path": "snap-29d33a42 (US West)", "type": "awsebs" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY3REM/awsS3Location' |
Response
HTTP/1.1 403 Forbidden Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) {"reason": "You are not authorized to access the requested resource and/or perform the requested activity"} |
This returns the metadata for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: -1673543886 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/annotations", "creationDate": 1298945441154, "description": "", "etag": "-1673543886", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "locations": [ "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/sageLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/awsS3Location", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/awsEBSLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/locations" ], "name": "genetic data", "platform": null, "preview": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/preview", "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "G", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "version": "0.0.1" } |
This returns the annotations for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/annotations' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 923521 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "creationDate": null, "dateAnnotations": {}, "doubleAnnotations": {}, "etag": "923521", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "longAnnotations": {}, "stringAnnotations": {}, "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/annotations" } |
This returns the preview data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/preview' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 246848728 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "etag": "246848728", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM", "preview": "genetic data preview", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/preview" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/sageLocation' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "path": "/Shares/external-data/DAT_030__human_liver_cohort", "type": "sage" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/awsS3Location' |
Response
HTTP/1.1 403 Forbidden Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) {"reason": "You are not authorized to access the requested resource and/or perform the requested activity"} |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY5xEM/awsEBSLocation' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "path": "snap_29d33a42 (US West)", "type": "awsebs" } |
This returns the metadata for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: -566282579 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "annotations": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/annotations", "creationDate": 1298945433633, "description": "", "etag": "-566282579", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "locations": [ "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsEBSLocation", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/locations", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsS3Location", "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/sageLocation" ], "name": "clinical data", "platform": null, "preview": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/preview", "processingFacility": null, "publicationDate": null, "qcBy": null, "qcDate": null, "releaseNotes": "", "tissueType": null, "type": "C", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "version": "0.0.1" } |
This returns the annotations for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/annotations' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 923521 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "creationDate": null, "dateAnnotations": {}, "doubleAnnotations": {}, "etag": "923521", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "longAnnotations": {}, "stringAnnotations": {}, "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/annotations" } |
This returns the preview data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/preview' |
Response
HTTP/1.1 200 OK Content-Type: application/json ETag: 345556318 Transfer-Encoding: chunked Server: Jetty(6.1.x) { "etag": "345556318", "id": "agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM", "preview": "clinical data preview", "uri": "/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/preview" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsEBSLocation' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "path": "snap-29d33a42 (US West)", "type": "awsebs" } |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsS3Location' |
Response
HTTP/1.1 403 Forbidden Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) {"reason": "You are not authorized to access the requested resource and/or perform the requested activity"} |
This returns the location data for a dataset layer.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/sageLocation' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "path": "/Shares/external-data/DAT_030__human_liver_cohort", "type": "sage" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "object" }, "optional": true, "properties": { "paging": { "optional": true, "type": "object" }, "results": { "items": { "items": { "optional": true, "type": "string" }, "optional": true, "properties": {"class": { "optional": true, "type": "string" }}, "type": "object" }, "optional": true, "type": "array" }, "totalNumberOfResults": { "optional": true, "type": "integer" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "boolean" }, "optional": true, "properties": { "annotations": { "optional": true, "type": "string" }, "creationDate": { "optional": true, "type": "number" }, "creator": { "optional": true, "type": "string" }, "description": { "optional": true, "type": "string" }, "etag": { "optional": true, "type": "string" }, "hasClinicalData": { "optional": true, "type": "boolean" }, "hasExpressionData": { "optional": true, "type": "boolean" }, "hasGeneticData": { "optional": true, "type": "boolean" }, "id": { "optional": true, "type": "string" }, "layer": { "optional": true, "type": "string" }, "name": { "optional": true, "type": "string" }, "releaseDate": { "optional": true, "type": "number" }, "status": { "optional": true, "type": "string" }, "uri": { "optional": true, "type": "string" }, "version": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/annotations/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "creationDate": { "optional": true, "type": "number" }, "dateAnnotations": { "optional": true, "type": "object" }, "doubleAnnotations": { "optional": true, "type": "object" }, "etag": { "optional": true, "type": "string" }, "id": { "optional": true, "type": "string" }, "longAnnotations": { "optional": true, "type": "object" }, "stringAnnotations": { "optional": true, "type": "object" }, "uri": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "object" }, "optional": true, "properties": { "paging": { "optional": true, "type": "object" }, "results": { "items": { "items": { "optional": true, "type": "string" }, "optional": true, "properties": {"class": { "optional": true, "type": "string" }}, "type": "object" }, "optional": true, "type": "array" }, "totalNumberOfResults": { "optional": true, "type": "integer" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "number" }, "optional": true, "properties": { "annotations": { "optional": true, "type": "string" }, "creationDate": { "optional": true, "type": "number" }, "description": { "optional": true, "type": "string" }, "etag": { "optional": true, "type": "string" }, "id": { "optional": true, "type": "string" }, "locations": { "items": { "optional": true, "type": "string" }, "optional": true, "type": "array" }, "name": { "optional": true, "type": "string" }, "platform": { "optional": true, "type": "string" }, "preview": { "optional": true, "type": "string" }, "processingFacility": { "optional": true, "type": "string" }, "publicationDate": { "optional": true, "type": "number" }, "qcBy": { "optional": true, "type": "string" }, "qcDate": { "optional": true, "type": "number" }, "releaseNotes": { "optional": true, "type": "string" }, "tissueType": { "optional": true, "type": "string" }, "type": { "optional": true, "type": "string" }, "uri": { "optional": true, "type": "string" }, "version": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/preview/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "etag": { "optional": true, "type": "string" }, "id": { "optional": true, "type": "string" }, "preview": { "optional": true, "type": "string" }, "uri": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsEBSLocation/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "path": { "optional": true, "type": "string" }, "type": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/locations/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "etag": { "optional": true, "type": "string" }, "id": { "optional": true, "type": "string" }, "locations": { "items": { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "path": { "optional": true, "type": "string" }, "type": { "optional": true, "type": "string" } }, "type": "object" }, "optional": true, "type": "array" }, "uri": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/awsS3Location/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "path": { "optional": true, "type": "string" }, "type": { "optional": true, "type": "string" } }, "type": "object" } |
The JsonSchema is an emerging standard similar to DTDs for XML.
Request
curl -i -H Accept:application/json 'http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyFAsSDUdBRUpET0RhdGFzZXQYtAQM/layer/agxkZWZsYXV4LXRlc3RyLwsSDUdBRUpET0RhdGFzZXQYtAQMCxIUR0FFSkRPSW5wdXREYXRhTGF5ZXIY0xEM/sageLocation/schema' |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "items": { "optional": true, "type": "string" }, "optional": true, "properties": { "path": { "optional": true, "type": "string" }, "type": { "optional": true, "type": "string" } }, "type": "object" } |
This is a REST api (see Service API Design for more details as to what this means). You can create entities, updated entities, read entities, and delete entities. More advanced querying will be implemented as a separate API. Partial updates (e.g., just updating two fields in a dataset) are not supported. In a nutshell, when you update something like a dataset, you GET the dataset first, modify the properties you want to change, and then send the entire object back to the service so that this revised entity overwrites the previously stored entity.
Request:
curl -i -H Accept:application/json -H Content-Type:application/json -d '{"name":"test dataset", "creator":"fake creator", "releaseDate":"2009-10-01", "status":"not curated"}' http://localhost:8080/repo/v1/dataset |
Response
HTTP/1.1 201 Created ETag: 1736839268 Location: /repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYBAw Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "name":"test dataset", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations", "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "version":"0.0.1", "creator":"fake creator", "description":null, "creationDate":1296595870715, "status":"not curated", "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "etag":"1309185941", "releaseDate":1254355200000, "layers":[] } |
Note that in the example below the creator and description fields have been changed but all others remain the same.
Request:
curl -i -H Accept:application/json -H Content-Type:application/json -X PUT -H ETag:1309185941 -d '{ "name":"test dataset", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations", "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "version":"0.0.1", "creator":"updated creator", "description":"I just added a description", "creationDate":1296595870715, "status":"not curated", "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "etag":"1309185941", "releaseDate":1254355200000, "layers":[] } ' http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw |
Response
HTTP/1.1 200 OK ETag: -852418664 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "name":"test dataset", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations", "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "version":"0.0.1", "creator":"updated creator", "description":"I just added a description", "creationDate":1296595870715, "status":"not curated", "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "etag":"-852418664", "releaseDate":1254355200000, "layers":[] } |
First get the empty annotations container for your newly created dataset
Request
curl -i -H Accept:application/json http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations |
Response
HTTP/1.1 200 OK ETag: 923521 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "creationDate":null, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations", "etag":"923521", "stringAnnotations":{ }, "floatAnnotations":{ }, "dateAnnotations":{ } } |
Then you add/modify the annotations of interest and do a PUT. Note that annotation values must always be list values even if the list is only of length one.
Request
curl -i -H Accept:application/json -H Content-Type:application/json -X PUT -H ETag:923521 -d '{ "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw", "creationDate":null, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations", "etag":"923521", "stringAnnotations":{ "Experimental Design Templates":["exp-122887", "exp-97765"] }, "floatAnnotations":{ "Number of Samples":[500] }, "dateAnnotations":{ "Publication Date":["2011-01-15"] } }' http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw/annotations |
Response
HTTP/1.1 200 OK ETag: -1638393853 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYBww", "creationDate":null, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYBww/annotations", "etag":"-1638393853", "stringAnnotations":{ "Experimental Design Templates":[ "exp-122887", "exp-97765" ] }, "floatAnnotations":{ "Number of Samples":[ 500.0 ] }, "dateAnnotations":{ "Publication Date":[ 1295049600000 ] } } |
Request
curl -i -X DELETE http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYAQw |
Response
HTTP/1.1 204 No Content Server: Jetty(6.1.x) |
Request
curl -i -H Accept:application/json http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer |
Response
HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "results":[ { "name":"Flint HS Mice Affy", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "type":"E", "version":"0.0.1", "description":"this is a description", "creationDate":1296690778880, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "etag":"1424771925", "publicationDate":null, "releaseNotes":"this is a release note", "tissueType":"liver", "platform":null, "processingFacility":null, "qcBy":null, "qcDate":null }, { "name":"Flint HS Mice Phenotypes", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjpBww/annotations", "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjpBww", "type":"C", "version":"0.0.1", "description":"this is a description", "creationDate":1296693007167, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjpBww", "etag":"1445062754", "publicationDate":null, "releaseNotes":"this is a release note", "tissueType":null, "platform":null, "processingFacility":null, "qcBy":null, "qcDate":null } ], "totalNumberOfResults":2, "paging":{ } } |
Request
curl -i -H Accept:application/json http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww |
Response
HTTP/1.1 200 OK ETag: 1240467407 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "name":"Flint HS Mice Affy", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "type":"E", "version":"0.0.1", "description":"this is a description", "creationDate":1296690778880, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "etag":"1240467407", "publicationDate":null, "releaseNotes":"this is a release note", "tissueType":null, "platform":null, "processingFacility":null, "qcBy":null, "qcDate":null } |
Request
curl -i -H Accept:application/json http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations |
Response
HTTP/1.1 200 OK ETag: 923521 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "creationDate":null, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "etag":"923521", "stringAnnotations":{ }, "floatAnnotations":{ }, "dateAnnotations":{ } } |
Request
curl -i -H Accept:application/json -H Content-Type:application/json -d '{"name":"Flint HS Mice Affy", "type":"E", "description":"this is a description", "releaseNotes":"this is a release note"}' http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer |
Response
HTTP/1.1 201 Created ETag: 1240467407 Location: /repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "name":"Flint HS Mice Affy", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "type":"E", "version":"0.0.1", "description":"this is a description", "creationDate":1296690778880, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "etag":"1240467407", "publicationDate":null, "releaseNotes":"this is a release note", "tissueType":null, "platform":null, "processingFacility":null, "qcBy":null, "qcDate":null } |
Now ask for the owning dataset and you can see the preview of the layer
Request
curl -i -H Accept:application/json http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww |
Response
HTTP/1.1 200 OK ETag: -801135512 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "name":"Flint HS Mice", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/annotations", "id":"agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww", "version":"0.0.1", "creator":"Jonathan Flint", "description":null, "creationDate":1296690549675, "status":"Future", "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww", "etag":"-801135512", "releaseDate":null, "layers":[ { "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "type":"E", "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww" },{ "id":"use this uri to make a new layer", "type":"hack", "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer" } ] } |
In the example below we updated the tissue type.
Request
curl -i -H Accept:application/json -H Content-Type:application/json -X PUT -H ETag:1240467407 -d ' { "name":"Flint HS Mice Affy", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "type":"E", "version":"0.0.1", "description":"this is a description", "creationDate":1296690778880, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "etag":"1240467407", "publicationDate":null, "releaseNotes":"this is a release note", "tissueType":"liver", "platform":null, "processingFacility":null, "qcBy":null, "qcDate":null }' http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww |
Response
HTTP/1.1 200 OK ETag: 1424771925 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "name":"Flint HS Mice Affy", "annotations":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "type":"E", "version":"0.0.1", "description":"this is a description", "creationDate":1296690778880, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "etag":"1424771925", "publicationDate":null, "releaseNotes":"this is a release note", "tissueType":"liver", "platform":null, "processingFacility":null, "qcBy":null, "qcDate":null } |
Request
curl -i -X DELETE http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww |
Response
HTTP/1.1 204 No Content Server: Jetty(6.1.x) |
Request
curl -i -H Accept:application/json -H Content-Type:application/json -X PUT -H ETag:923521 -d ' { "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "creationDate":null, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "etag":"923521", "stringAnnotations":{ "notes":["I threw away 6 samples during the curation process due to gender chromosome mismatches"] }, "floatAnnotations":{ }, "dateAnnotations":{ } }' http://localhost:8080/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations |
Response
HTTP/1.1 200 OK ETag: -1897035229 Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(6.1.x) { "id":"agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww", "creationDate":null, "uri":"/repo/v1/dataset/agxkZWZsYXV4LXRlc3RyEwsSDUdBRUpET0RhdGFzZXQYUww/layer/agxkZWZsYXV4LXRlc3RyLgsSDUdBRUpET0RhdGFzZXQYUwwLEhRHQUVKRE9JbnB1dERhdGFMYXllchjoBww/annotations", "etag":"-1897035229", "stringAnnotations":{ "notes":[ "I threw away 6 samples during the curation process due to gender chromosome mismatches" ] }, "floatAnnotations":{ }, "dateAnnotations":{ } } |