Get Concept Web Service

The Get Concept Web service is used to get the full description of a UMBEL Reference Concept. By querying this Web service endpoint, you will get the preferred label, all the alternative labels (namely, the items in the semset, the sub/super classes of the concept, the broader/narrower concepts and the description of that concept.

 
This is the Web service endpoint that should be used to get the direct relationships with any other reference concept.

Usage

This Web service is intended to be used by any user that wants to get the description of a UMBEL reference concept. No permissions are required to query this Web service endpoint. To access this endpoint, you simply have to send a HTTP GET query to the proper endpoint URL per the specifications below.
 
HTTP Method:
  • GET
Possible Accept: HTTP header field value:
  • */*: return the N-Triples serialization of the resultset
  • text/plain: return the N-Triples serialization of the resultset
  • application/rdf+n3: return the N-Triples serialization of the resultset
  • application/rdf+xml: return the RDF+XML serialization of the resultset
  • application/json: return the structJSON serialization of the resultset
  • application/iron+json: return the structJSON serialization of the resultset
  • application/*: return the structJSON serialization of the resultset
  • application/clojure: return a Clojure map structure
URL:
  • http://umbel.org/ws/concept/uri
Parameters:
  • uri: this parameter is the end URI of a UMBEL reference concept such as Person that refers to its full URI http://umbel.org/umbel/rc/Person.

Serializations

The Get Concept endpoint currently supports four serialization formats:
 
A Get Concept N-Triples result for the umbel:Coffee_Ground reference concept looks like:
 
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://purl.org/ontology/umbel#superClassOf> <http://www.w3.org/2004/02/skos/core#Collection> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://purl.org/ontology/umbel#superClassOf> <http://www.w3.org/2004/02/skos/core#ConceptScheme> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://purl.org/ontology/umbel#superClassOf> <http://www.w3.org/2004/02/skos/core#OrderedCollection> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/2004/02/skos/core#altLabel> """coffee""" .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/2004/02/skos/core#definition> """Quantities of coffee grinds.""" .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/1999/02/22-rdf-syntax-ns#subClassOf> <http://umbel.org/umbel/rc/Granular> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/1999/02/22-rdf-syntax-ns#subClassOf> <http://umbel.org/umbel/rc/PlantProduct> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/1999/02/22-rdf-syntax-ns#subClassOf> <http://umbel.org/umbel/rc/FoodIngredientOnly> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://purl.org/dc/terms/isPartOf> <http://vanilla.opensemanticframework.org/datasets/umbel/> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#Class> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://umbel.org/umbel#RefConcept> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#NamedIndividual> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/2004/02/skos/core#prefLabel> """ground coffee""" .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/2004/02/skos/core#broaderTransitive> <http://umbel.org/umbel/rc/Granular> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/2004/02/skos/core#broaderTransitive> <http://umbel.org/umbel/rc/PlantProduct> .
  <http://umbel.org/umbel/rc/Coffee_Ground> <http://www.w3.org/2004/02/skos/core#broaderTransitive> <http://umbel.org/umbel/rc/FoodIngredientOnly> .          
          
 
A Get Concept RDF+XML result for the umbel:Coffee_Ground reference concept looks like:
 
  <?xml version="1.0" encoding="utf-8" ?>

  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#">
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:altLabel xmlns:pred="http://www.w3.org/2004/02/skos/core#">coffee</pred:altLabel></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:definition xmlns:pred="http://www.w3.org/2004/02/skos/core#">Quantities of coffee grinds.</pred:description></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:prefLabel xmlns:pred="http://www.w3.org/2004/02/skos/core#">ground coffee</pred:prefLabel></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:superClassOf xmlns:pred="http://purl.org/ontology/umbel#" rdf:resource="http://www.w3.org/2004/02/skos/core#Collection" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:superClassOf xmlns:pred="http://purl.org/ontology/umbel#" rdf:resource="http://www.w3.org/2004/02/skos/core#ConceptScheme" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:superClassOf xmlns:pred="http://purl.org/ontology/umbel#" rdf:resource="http://www.w3.org/2004/02/skos/core#OrderedCollection" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:subClassOf xmlns:pred="http://www.w3.org/TR/rdf-schema#" rdf:resource="http://umbel.org/umbel/rc/Granular" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:subClassOf xmlns:pred="http://www.w3.org/TR/rdf-schema#" rdf:resource="http://umbel.org/umbel/rc/PlantProduct" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:subClassOf xmlns:pred="http://www.w3.org/TR/rdf-schema#" rdf:resource="http://umbel.org/umbel/rc/FoodIngredientOnly" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:broaderTransitive xmlns:pred="http://www.w3.org/2004/02/skos/core#" rdf:resource="http://umbel.org/umbel/rc/Granular" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:broaderTransitive xmlns:pred="http://www.w3.org/2004/02/skos/core#" rdf:resource="http://umbel.org/umbel/rc/PlantProduct" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:broaderTransitive xmlns:pred="http://www.w3.org/2004/02/skos/core#" rdf:resource="http://umbel.org/umbel/rc/FoodIngredientOnly" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:type xmlns:pred="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rdf:resource="http://www.w3.org/2002/07/owl#Class" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:type xmlns:pred="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rdf:resource="http://umbel.org/umbel#RefConcept" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel/rc/Coffee_Ground"><pred:type xmlns:pred="http://www.w3.org/1999/02/22-rdf-syntax-ns#" rdf:resource="http://www.w3.org/2002/07/owl#NamedIndividual" /></rdf:Description>
  </rdf:RDF>          
          
 
A Get Concept structJSON result for the umbel:Coffee_Ground reference concept looks like:
 
  {
      "prefixes": {},
      "resultset": {
          "subject": [
              {
                  "uri": "http://umbel.org/umbel/rc/Coffee_Ground",
                  "predicate": [
                      {
                          "http://www.w3.org/2004/02/skos/core#altLabel": "coffee"
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#definition": "Quantities of coffee grinds."
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#prefLabel": "ground coffee"
                      },
                      {
                          "http://purl.org/ontology/umbel#superClassOf": {
                              "uri": "http://www.w3.org/2004/02/skos/core#Collection"
                          }
                      },
                      {
                          "http://purl.org/ontology/umbel#superClassOf": {
                              "uri": "http://www.w3.org/2004/02/skos/core#ConceptScheme"
                          }
                      },
                      {
                          "http://purl.org/ontology/umbel#superClassOf": {
                              "uri": "http://www.w3.org/2004/02/skos/core#OrderedCollection"
                          }
                      },
                      {
                          "http://www.w3.org/TR/rdf-schema#subClassOf": {
                              "uri": "http://umbel.org/umbel/rc/Granular",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "granular thing"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/TR/rdf-schema#subClassOf": {
                              "uri": "http://umbel.org/umbel/rc/PlantProduct",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "plant product"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/TR/rdf-schema#subClassOf": {
                              "uri": "http://umbel.org/umbel/rc/FoodIngredientOnly",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "food ingredient"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#broaderTransitive": {
                              "uri": "http://umbel.org/umbel/rc/Granular",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "granular thing"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#broaderTransitive": {
                              "uri": "http://umbel.org/umbel/rc/PlantProduct",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "plant product"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#broaderTransitive": {
                              "uri": "http://umbel.org/umbel/rc/FoodIngredientOnly",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "food ingredient"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/1999/02/22-rdf-syntax-ns#type": {
                              "uri": "http://www.w3.org/2002/07/owl#Class"
                          }
                      },
                      {
                          "http://www.w3.org/1999/02/22-rdf-syntax-ns#type": {
                              "uri": "http://umbel.org/umbel#RefConcept"
                          }
                      },
                      {
                          "http://www.w3.org/1999/02/22-rdf-syntax-ns#type": {
                              "uri": "http://www.w3.org/2002/07/owl#NamedIndividual"
                          }
                      }
                  ]
              }
          ]
      }
  }          
          
 
A Get Concept Clojure result for the umbel:Coffee_Ground super type looks like:
 
  {#'rdf.core/uri "http://umbel.org/umbel/rc/Coffee_Ground"
   #'iron:alt-label ["coffee"]
   #'iron:description ["Quantities of coffee grinds."]
   #'iron:pref-label ["ground coffee"]
   #'umbel:super-class-of ["http://www.w3.org/2004/02/skos/core#Collection"
                           "http://www.w3.org/2004/02/skos/core#ConceptScheme"
                           "http://www.w3.org/2004/02/skos/core#OrderedCollection"]
   #'rdfs:sub-class-of ["http://umbel.org/umbel/rc/Granular"
                        "http://umbel.org/umbel/rc/PlantProduct"
                        "http://umbel.org/umbel/rc/FoodIngredientOnly"]
   #'skos:broader-transitive ["http://umbel.org/umbel/rc/Granular"
                              "http://umbel.org/umbel/rc/PlantProduct"
                              "http://umbel.org/umbel/rc/FoodIngredientOnly"]
    #'rdf:type ["http://www.w3.org/2002/07/owl#Class" 
                "http://umbel.org/umbel#RefConcept" 
                "http://www.w3.org/2002/07/owl#NamedIndividual"]}
          
 

Examples

Here are a series of examples that use cURL for querying the get concept web service endpoint.
 
Get the description of the Person refence concept in RDF+XML:
  curl -H "Accept: application/rdf+xml" "http://umbel.org/ws/concept/Person"
 
Get the description of the Person refence concept in N-Triples:
  curl -H "Accept: text/plain" "http://umbel.org/ws/concept/Person"
 
Get the description of the Person refence concept in structJSON:
  curl -H "Accept: application/iron+json" "http://umbel.org/ws/concept/Person"
 
Get the description of the Person refence concept in Clojure:
  curl -H "Accept: application/clojure" "http://umbel.org/ws/concept/Person"
 

Errors

Here is the list of possible HTTP errors that can be returned by this endpoint:
 
HTTP Error Message Description
404
Requested resource not existing The URL of the web service is not properly constructed. This usually happens if you write URLs like http://umbel.org/ws/concept/Person/
406
Unsuppoted mime requested The Accept: HTTP headers doesn't contain any supported mime types. If this happens, make sure that you are requesting a supported mime type.
500
empty An internal UMBEL Web service error occurred. If this happens, please contact us with the query that caused the error.
 

Copyright © 2008-2017. Structured Dynamics LLC. All content available via Creative Commons Attribution 3.0