Retrieving meta data about an object

The meta data API provides access to internal information about a thing which are not defined in the DS.
Please use this local name to retrieve the meta data.

Currently, the meta data endpoint returns the following information

  • the id of the requested object
  • dateCreated => the creation date of the object
  • dateModiefied => the last modification date of the object
  • publisher => the publisher UUID (for which publisher was the object inserted or updated)
  • datasource => the datasource UUID (from which data source or data provider was the object inserted or modified)
  • ds => the domain specification of the object, including the labels

Example call

curl --location --request GET 'https://proxy.opendatagermany.io/api/ts/v1/kg/things/meta/$LOCAL_NAME' \
--header 'X-PUBLISHER: $PUBLISHER_UUID' \
--header 'Content-Type: application/json' \
--header 'X-DATASOURCE: $DATASOURCE_UUID' \
--header 'x-api-key: $API_KEY'

Example call with external identifier

Here is an example call for our LocalBusiness running example:

curl --location --request GET 'https://proxy.opendatagermany.io/api/ts/v1/kg/things/meta/LB1?ns=http://example.com/entity/' \
--header 'X-PUBLISHER: $PUBLISHER_UUID' \
--header 'Content-Type: application/json' \
--header 'X-DATASOURCE: $DATASOURCE_UUID' \
--header 'x-api-key: $API_KEY'

with the following response

{
    "id": "http://example.com/entity/LB1",
    "publisher": "http://onlim.com/entity/98f8a419-c8b2-44ce-bbb8-1bfa29065ccc",
    "datasource": "http://onlim.com/entity/98f8a419-c8b2-44ce-bbb8-1bfa29065ccc",
    "dateCreated": "2023-01-10T13:37:30+00",
    "dateModified": "2023-01-10T13:44:54+00",
    "ds": {
        "https://semantify.it/ds/uGBhB9lBI": {
            "en": "LocalBusiness"
        }
    }
}

What’s Next

Next, let us see how one can access the data in the knowledge graph