Title: Entityhub

The Entityhub provides two main services. The Entityhub provides the connection to external linked open data sites as well as using indexes of them locally. Its services allow to manage a __network of sites__ to consume entity information and to __manage entities locally__.  

A small index of approx. 43k entities from dbpedia comes with the default installation.

## Service Endpoints

The RESTful API of the Entityhub ist structured as follows:

### Entity Network ("/entityhub/site*"):

- The Referenced Site Manager @ [/entityhub/sites](http://localhost:8080/entityhub/sites) allows to manages sites and retrieve/search Entities in all sites of the Entity Network.
- A Referenced Site @ /entityhub/site/{siteName} refers to a single site of the Referenced Site Manager and allows to retrieve all active sites. Referenced sites provide the same interface as the referenced site manager.

 For both services, several features are available:

 - [__Referenced__](http://localhost:8080/entityhub/sites/referenced) returns a json array containing the IDs of all available sites. Sites returned by this method can be accessed via the site service endpoint.

 - [__Entity__](http://localhost:8080/entityhub/sites/entity) searches all referenced sites for the entity with the parsed URI.

 - [__Find__](http://localhost:8080/entityhub/sites/find) provides a label based search service over all sites.

 - [__Query__](http://localhost:8080/entityhub/sites/query) allows to parse JSON serialized field queries to the sites endpoint.

 Currently active referenced sites at the demo server are available and running for [dbpedia](http://dev.iks-project.eu:8080/entityhub/site/dbpedia/), [dplp](http://dev.iks-project.eu:8080/entityhub/site/dblp/) and [geonames](http://dev.iks-project.eu:8080/entityhub/site/geonames/).
       

### Entityhub ("/entityhub"):

- Local Entities @/entityhub/entity: Full CRUD operations on Entities managed by the Entityhub
- Entity Mappings @ /entityhub/mapping: Lookup mappings from local Entities to Entities managed by a Referenced Site
- Local Search @/entityhub/find: Find locally managed Entities by label based search.
- Local Query @/entityhub/query: Find locally managed Entities by parsing queries
- Entity Lookup @/entityhub/lookup: Lookup Entities by id. This supports also to lookup Entities managed by Referenced Sites and the import of found Entities to the Entityhub.