FAIRDataPoint is a REST api for creating, storing and servering FAIR metadata. The metadata contents are in this api are generated semi-automatically according to the FAIR Data Point software specification document. In the current version of api we support GET, POST and PATCH requests.
- JRE 1.8
- Tomcat 7 or higher
Make sure your deployment machine meets the requirements listed above. Deploy the fdp.war file (download link can be found here) in your deployment machine's tomcat server. The instructions for deploying .war in the tomcat server can be found in this link.
FAIRDataPoint (fdp) api comes with an embedded [swagger document] (http://swagger.io/), the details of api calls can be found here. To access the fdp swagger document please visit the following url via web browser
<TOMCAT_BASE_URL>/fdp/swagger-ui.html
An example swagger doc uri : http://localhost:8084/fdp/swagger-ui.html
In the current implementation the REPOSITORY layer metadata is automatically created, however this metadata can be updated through PATCH calls. The metadata of other layers can be stored in the FAIRDataPoint through POST calls. The table below gives an overview of api calls allowed on different FAIR metadata layers.
| Metadata layer | GET | POST | PATCH |
|---|---|---|---|
| Repository | Yes | No | Yes (Example request body) |
| Catalog | Yes | Yes (Example request body) |
No |
| Dataset | Yes | Yes (Example request body) |
No |
| Distribution | Yes | Yes (Example request body) |
No |
| Short name (dct:title) | Description | Location |
|---|---|---|
| ID card FAIR Data Point (beta) | FDP containing dummified data from Biobanks and Registries | Link |
| DTL FAIR Data Point (beta) | FDP for the fairification doc (VCF); fantom5; GeneDisease/DisGeNet | Link |