Report Open Access

Final API available for internal and external service providers (Deliverable 2.4)

Bachler, Daniel; Dokler, Joh; Dudgeon, Tim; Willighagen, Egon; Karatzas, Pantelis; Lynch, Iseult; Hardy, Barry; Exner, Thomas


JSON-LD (schema.org) Export

{
  "description": "<p>This document reports the work on the final API specification for semantic interoperability that was developed as part of the OpenRiskNet e-infrastructure. It briefly outlines the challenges encountered and the solution that has been implemented and is now in use in OpenRiskNet.</p>\n\n<p>This deliverable is related to Task 2.2 (API specification and semantic interoperability) and in a continuation of the work performed within <a href=\"https://doi.org/10.5281/zenodo.1479444\">Deliverable 2.2</a> (Initial API version provided to providers of services), that are now in the process of being incorporated into OpenRiskNet as part of the service catalogue. Deliverable 2.2 gives in-depth information on the evaluation of the various technologies for describing APIs we considered, whereas this report focuses on the solution that was finally chosen and put in place, and the justification of this choice to support other databases / e-infrastructures in their deliberations on API solutions.</p>\n\n<p>The main requirement of describing operations of an API, on both the semantic and technical (structural) levels, was met by creating a novel fusion of the well established OpenAPI standard and the tools of linked data using JSON-LD. This combination allowed us to use and reuse the already existing OpenAPI definitions (and already available OpenAPI tooling), and combine it, with relatively little effort for a service provider, with semantic annotations to facilitate interoperability. The OpenRiskNet Service Registry was developed to scan for such &ldquo;OpenRiskNet annotated OpenAPI definitions&rdquo; of active services running in an OpenShift cluster and indexes the data to provide semantic queries using the well established SPARQL linked data query language.</p>", 
  "license": "https://creativecommons.org/licenses/by/4.0/legalcode", 
  "creator": [
    {
      "affiliation": "Edelweiss Connect", 
      "@type": "Person", 
      "name": "Bachler, Daniel"
    }, 
    {
      "affiliation": "Edelweiss Connect", 
      "@type": "Person", 
      "name": "Dokler, Joh"
    }, 
    {
      "affiliation": "Informatics Matters Ltd", 
      "@type": "Person", 
      "name": "Dudgeon, Tim"
    }, 
    {
      "affiliation": "Universiteit Maastricht", 
      "@type": "Person", 
      "name": "Willighagen, Egon"
    }, 
    {
      "affiliation": "National Technical University Of Athens", 
      "@type": "Person", 
      "name": "Karatzas, Pantelis"
    }, 
    {
      "affiliation": "University Of Birmingham", 
      "@type": "Person", 
      "name": "Lynch, Iseult"
    }, 
    {
      "affiliation": "Edelweiss Connect", 
      "@type": "Person", 
      "name": "Hardy, Barry"
    }, 
    {
      "affiliation": "Edelweiss Connect", 
      "@type": "Person", 
      "name": "Exner, Thomas"
    }
  ], 
  "headline": "Final API available for internal and external service providers (Deliverable 2.4)", 
  "image": "https://zenodo.org/static/img/logos/zenodo-gradient-round.svg", 
  "datePublished": "2019-03-18", 
  "url": "https://zenodo.org/record/2597061", 
  "keywords": [
    "Application programming interface", 
    "e-infrastructure"
  ], 
  "@context": "https://schema.org/", 
  "identifier": "https://doi.org/10.5281/zenodo.2597061", 
  "@id": "https://doi.org/10.5281/zenodo.2597061", 
  "@type": "ScholarlyArticle", 
  "name": "Final API available for internal and external service providers (Deliverable 2.4)"
}
53
28
views
downloads
All versions This version
Views 5353
Downloads 2828
Data volume 13.9 MB13.9 MB
Unique views 4141
Unique downloads 2222

Share

Cite as