Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titleinfo

The data collection service is a data hub to store and retrieve JSON files for communication and synchronization of data between different services. It provides a REST API for storing and retrieving json data. Services that use the data collection service get their own secret key for secure authentication.


Overview


Panel
borderColor#7AF842
borderWidth2

Status:

Status
colourGreen
titleProductive

Weblink: collections.gfbio.org

Target group: service provider

Keywords: data exchange, JSON, API

RDC Integration: integrated or connected

Product owner: GFBio e.V.




RDC Integration

Embed draw.io Diagram
diagramNameRDC-mediation-layer
includedDiagram1
width872
pageId111053329

The GFBio Data Collections Service is currently used to send data selected within the GFBio Data Search and transfer it to the Visualization and Analysis tool.

Getting started

You can use the Data Collection Service as an independent micro-service to exchange data between multiple services. The Data Collection Service is agnostic to the contents of the data, the only requirement is that is is formatted as a valid JSON document. Currently, the service does not provide structural or administrative metadata. A collection needs to be mapped to a user id. The service is agnostic to the type and source of the user id. Currently service providers need to agree on the format of the data and the user id format independently of the Data Collections Service.  

User Guide

The data collections service is a technical service that is intended for exchanging data in JSON format between user-facing services in RDC. As such the collection service currently only offers a REST API and no graphical or command line user interface. The primary target audience are RDC developers and service providers. Please refer to the developer guide API Documentation for details on usage.

Developer Guide

Token-based Authentication


Deployment Guide

Please refer to the "developer guide" section on GitHub if you plan to deploy your own instance of this service.The most current version of the developer guide is available on GitHub under https://github.com/gfbio/gfbio-data-collections#developer-guide

References

Publications