Stanbol Home

The RESTful Semantic Engine

Entityhub Lookup

Subresource /lookup?id={uri}&create={create}

Description This service looks-up Symbols (Entities managed by the Entityhub) based on the parsed URI. The parsed ID can be the URI of a Symbol or an Entity of any referenced site.
  • If the parsed ID is a URI of a Symbol, than the stored information of the Symbol are returned in the requested media type ('accept' header field).
  • If the parsed ID is a URI of an already mapped entity, then the existing mapping is used to get the according Symbol.
  • If "create" is enabled, and the parsed URI is not already mapped to a Symbol, than all the currently active referenced sites are searched for an Entity with the parsed URI.
  • If the configuration of the referenced site allows to create new symbols, than a the entity is imported in the Entityhub, a new Symbol and EntityMapping is created and the newly created Symbol is returned.
  • In case the entity is not found (this also includes if the entity would be available via a referenced site, but create=false) a 404 "Not Found" is returned.
  • In case the entity is found on a referenced site, but the creation of a new Symbol is not allowed a 403 "Forbidden" is returned.
Request GET /lookup?id={uri}&create={create}
Parameter
  • id: the id of the entity
  • create: if "true" a new symbol is created if necessary and allowed
Produces Depends on requested media type

Example

curl "http://demo2.fogbeam.org:8080/entityhub/lookup/?id=http://dbpedia.org/resource/Paris&create=false"

Test