OpenCGA RESTful Web Services
HGVA is powered by the Open Computational Genomic Analysis (OpenCGA) project. OpenCGA implements an extensive API that enables numerous operations over metadata, samples and genomic data. The whole API specification can be accessed at:
A description of the API and URLs design can be found at the OpenCGA Using OpenCGA documentation.
The tutorial Using RESTful Web Services URL shows practical examples on how to directly query the RESTful API. It focuses on those end points of the API which are of more interest for HGVA users, giving examples of their use and pin pointing certain peculiarities of the parameters for HGVA. Data is hierarchically organised in Projects and Studies. Please, in order to understand the API behaviour, have a look at Datasets and Studies in order to first how data is organized: Projects, Studies and Cohorts . For details on the query parameters, please refer to the Swagger documentation linked above.
The Java client library is distributed together with the rest of the OpenCGA code:
It offers a Java API to all the functionality provided by the Using OpenCGA. Please, refer to Using the Java REST client for further details on how to get the code, configure, build and use the library. Only those methods which are of more interest to HGVA users are described in that tutorial.
pyCGA is the Python client library for Using OpenCGA, all the web services are accessible through this client, and it offers a quick way to query OpenCGA projects programmatically from custom scripts. The Python client library is distributed with the rest of the OpenCGA code.
GitHub provides a public issue tracker which enables users to provide comments and contributions.
Please, refer to the tutorial Using the Python REST client in order to get detailed instructions for installing and configuring it, as well as a list of the methods which are of more interest for HGVA users and practical examples on how to use them.