Umaka REST API

Umaka Data provides information about Linked Data endpoints. We can access the information via REST API. This document shows how we can retrieve the data.

API can be accessed over HTTP from 'https://yummydata.org', and API returns data as JSON.

You can retrieve information of all endpoints as follows:

curl -L -H 'Accept: application/json' https://yummydata.org/api/endpoint/search

This return the list of information of endpoints as follows:

[
  {
    "id": 1,
    "name": "Allie",
    "endpoint_url": "http://data.allie.dbcls.jp/sparql",
    "description_url": "http://data.allie.dbcls.jp/",
    "evaluation": {
      "started_at": "2019-01-01T00:00:00.000Z",
      "rank": "A",
      "score": 100,
      "publisher": [
        "http://dbcls.jp/"
      ],
      "license": [
        "http://creativecommons.org/licenses/by/2.1/jp/"
      ],
      "language": [
        "SPARQL11Query"
      ],
      "service_keyword": true,
      "graph_keyword": true,
      "data_scale": "8.0",
      "cors": true,
      "alive": true,
      "alive_rate": 1.0,
      "last_updated": "2019-01-01",
      "service_description": true,
      "void": true,
      "metadata": 100.0,
      "ontology": 100.0,
      "links_to_other_datasets": [],
      "data_entry": 100000000,
      "support_html_format": true,
      "support_rdfxml_format": true,
      "support_turtle_format": true,
      "cool_uri": 100,
      "http_uri": true,
      "provide_useful_information": true,
      "link_to_other_uri": true,
      "execution_time": 1.000
    }
  }, ...
]

We can specify the conditions using URL parameters. Please see the table below for all parameters.

Example: Retrieve information of endpoints which name contains "Life" as follows:

curl -L -H 'Accept: application/json' https://yummydata.org/api/endpoint/search?name=Life

Example: Retrieve information of endpoints which Umaka score is between 50 and 70 as follows:

curl -L -H 'Accept: application/json' https://yummydata.org/api/endpoint/search?score_lower=50&score_upper=70

Example: Retrieve information of endpoints which alive rate is more than 75% as follows:

curl -L -H 'Accept: application/json' https://yummydata.org/api/endpoint/search?alive_rate_lower=75

Example: Retrieve information of endpoints which has service description as follows:

curl -L -H 'Accept: application/json' https://yummydata.org/api/endpoint/search?service_description=1