Get Super Type Web Service

The Get Super Type Web service is used to get the full description of a UMBEL Super Type. By querying this Web service endpoint, you will get the preferred label, all of the alternative labels, the description, and the disjoint super types of a target super type.

Usage

This Web service is intended to be used by any user that wants to get the description of a UMBEL super type. 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+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/super-type/uri
Parameters:
  • uri: this parameter is the end URI of a UMBEL super type such as Animals that refers to its full URI http://umbel.org/umbel#Animals.

Serializations

The Get Super Type endpoint currently supports four serialization formats:
 
A Get Super Type N-Triples result for the umbel:Animals super type looks like:
 
  <http://umbel.org/umbel#Animals> <http://www.w3.org/TR/rdf-schema#subClassOf> <http://umbel.org/umbel#SuperType> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Activities> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#AudioInfo> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Drugs> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Earthscape> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Events> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Extraterrestrial> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Facilities> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#FinanceEconomy> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Geopolitical> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#NaturalPhenomena> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#NaturalSubstances> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Notations> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Numbers> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Plants> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Prokaryotes> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#ProtistsFungus> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#StructuredInfo> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Time> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#VisualInfo> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#Workplaces> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2002/07/owl#disjointWith> <http://umbel.org/umbel#WrittenInfo> .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2004/02/skos/core#definition> """This large SuperType includes all animal types, including specific animal types and vertebrates, invertebrates, insects, crustaceans, fish, reptiles, amphibia, birds, mammals, and animal body parts. Animal parts are specifically included. Also, groupings of such animals are included. Humans, as an animal, are included (versus as an individual Person). Diseases are specifically excluded. Animals have many of the similar overlaps to Plants. However, in addition, there are more terms for animal groups, animal parts, animal secretions, etc. Also Animals can include some human traits (posture, dead animal, etc) """ .
  <http://umbel.org/umbel#Animals> <http://www.w3.org/2004/02/skos/core#prefLabel> """animals""" .
          
 
A Get Super Type RDF+XML result for the umbel:Animals super type 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#Animals"><pred:subClassOf xmlns:pred="http://www.w3.org/TR/rdf-schema#" rdf:resource="http://umbel.org/umbel#SuperType" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Activities" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#AudioInfo" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Drugs" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Earthscape" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Events" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Extraterrestrial" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Facilities" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#FinanceEconomy" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Geopolitical" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#NaturalPhenomena" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#NaturalSubstances" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Notations" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Numbers" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Plants" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Prokaryotes" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#ProtistsFungus" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#StructuredInfo" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Time" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#VisualInfo" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#Workplaces" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:disjointWith xmlns:pred="http://www.w3.org/2002/07/owl#" rdf:resource="http://umbel.org/umbel#WrittenInfo" /></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:definition xmlns:pred="http://www.w3.org/2004/02/skos/core#">This large SuperType includes all animal types, including specific animal types and vertebrates, invertebrates, insects, crustaceans, fish, reptiles, amphibia, birds, mammals, and animal body parts. Animal parts are specifically included. Also, groupings of such animals are included. Humans, as an animal, are included (versus as an individual Person). Diseases are specifically excluded. Animals have many of the similar overlaps to Plants. However, in addition, there are more terms for animal groups, animal parts, animal secretions, etc. Also Animals can include some human traits (posture, dead animal, etc) </pred:description></rdf:Description>
  <rdf:Description rdf:about="http://umbel.org/umbel#Animals"><pred:prefLabel xmlns:pred="http://www.w3.org/2004/02/skos/core#">animals</pred:prefLabel></rdf:Description>
  </rdf:RDF>          
          
 
A Get Super Type structJSON result for the umbel:Animals super type looks like:
 
  {
      "prefixes": {},
      "resultset": {
          "subject": [
              {
                  "uri": "http://umbel.org/umbel#Animals",
                  "predicate": [
                      {
                          "http://www.w3.org/TR/rdf-schema#subClassOf": {
                              "uri": "http://umbel.org/umbel#SuperType",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "SuperType"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Activities",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "activities"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#AudioInfo",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "audio information"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Drugs",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "drugs"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Earthscape",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "earthscape"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Events",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "events"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Extraterrestrial",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "Extraterrestrial"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Facilities",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "facilities"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#FinanceEconomy",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "fnance and economy"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Geopolitical",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "geopolitical"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#NaturalPhenomena",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "natural phenomena"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#NaturalSubstances",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "natural substance"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Notations",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "notations"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Numbers",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "numbers"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Plants",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "plants"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Prokaryotes",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "prokaryotes"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#ProtistsFungus",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "protists fungus"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#StructuredInfo",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "structured information"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Time",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "time"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#VisualInfo",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "visual information"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#Workplaces",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "workplaces"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2002/07/owl#disjointWith": {
                              "uri": "http://umbel.org/umbel#WrittenInfo",
                              "reify": [
                                  {
                                      "type": "iron:prefLabel",
                                      "value": "written information"
                                  }
                              ]
                          }
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#definition": "This large SuperType includes all animal types, including specific animal types and vertebrates, invertebrates, insects, crustaceans, fish, reptiles, amphibia, birds, mammals, and animal body parts. Animal parts are specifically included. Also, groupings of such animals are included. Humans, as an animal, are included (versus as an individual Person). Diseases are specifically excluded. Animals have many of the similar overlaps to Plants. However, in addition, there are more terms for animal groups, animal parts, animal secretions, etc. Also Animals can include some human traits (posture, dead animal, etc) "
                      },
                      {
                          "http://www.w3.org/2004/02/skos/core#prefLabel": "animals"
                      }
                  ]
              }
          ]
      }
  }          
          
 
A Get Super Type Clojure result for the umbel:Animals super type looks like:
 
{#'rdf.core/uri "http://umbel.org/umbel#Animals"
 #'rdfs:sub-class-of ["http://umbel.org/umbel#SuperType"]
 #'owl:disjoint-with ["http://umbel.org/umbel#Activities"
                      "http://umbel.org/umbel#AudioInfo"
                      "http://umbel.org/umbel#Drugs"
                      "http://umbel.org/umbel#Earthscape"
                      "http://umbel.org/umbel#Events"
                      "http://umbel.org/umbel#Extraterrestrial"
                      "http://umbel.org/umbel#Facilities"
                      "http://umbel.org/umbel#FinanceEconomy"
                      "http://umbel.org/umbel#Geopolitical"
                      "http://umbel.org/umbel#NaturalPhenomena"
                      "http://umbel.org/umbel#NaturalSubstances"
                      "http://umbel.org/umbel#Notations"
                      "http://umbel.org/umbel#Numbers"
                      "http://umbel.org/umbel#Plants"
                      "http://umbel.org/umbel#Prokaryotes"
                      "http://umbel.org/umbel#ProtistsFungus"
                      "http://umbel.org/umbel#StructuredInfo"
                      "http://umbel.org/umbel#Time"
                      "http://umbel.org/umbel#VisualInfo"
                      "http://umbel.org/umbel#Workplaces"
                      "http://umbel.org/umbel#WrittenInfo"]
  #'iron:description ["This large SuperType includes all animal types, including specific animal types and vertebrates, invertebrates, insects, crustaceans, fish, reptiles, amphibia, birds, mammals, and animal body parts. Animal parts are specifically included. Also, groupings of such animals are included. Humans, as an animal, are included (versus as an individual Person). Diseases are specifically excluded. Animals have many of the similar overlaps to Plants. However, in addition, there are more terms for animal groups, animal parts, animal secretions, etc. Also Animals can include some human traits (posture, dead animal, etc) "]
  #'iron:pref-label ["animals"]}          
          
 

Examples

Here are a series of examples that use cURL for querying the get super type web service endpoint.
 
Get the description of the Animals super type in RDF+XML:
  curl -H "Accept: application/rdf+xml" "http://umbel.org/ws/super-type/Person"
 
Get the description of the Animals super type in N-Triples:
  curl -H "Accept: text/plain" "http://umbel.org/ws/super-type/Person"
 
Get the description of the Animals super type in structJSON:
  curl -H "Accept: application/iron+json" "http://umbel.org/ws/super-type/Person"
 
Get the description of the Animals super type in Clojure:
  curl -H "Accept: application/clojure" "http://umbel.org/ws/super-type/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/super-type/Animals/
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