Getting started with Hypercat


For machine readable access, datahub has exposed a hypercat catalogue, which can be accessed at datahub under /cat:
http:https://datahub.rp.bt.com/cat

User interface for the hypercat catalogue is located at http://search.bt-hypercat.co.uk.

Hypercat UI

UI, located at http://search.bt-hypercat.co.uk, allows easy to use hypercat feature overview. It is possible to view (default) datahub hypercat or point the interface to your own. Features available to use in the UI are:
  • Authentication
  • Simple Search
  • PrefixSearch
  • LexicoGraphicSearch
  • GeoSearch
  • GeoDateSearch
Alternatively, you can interact with the hypercat directly. Details of the hypercat standard can be found at http://www.hypercat.io/standard.html.


Examples

Search Type HTTP Method Parameters  Example(s)
Simple Search GET rel
val
href
http:https://datahub.rp.bt.com/cat?val=weather&href=http://api.bt-hypercat.com/sensors/feeds/fa899552-044a-48e2-bdbe-0076292fd4a2
Prefix Match Search GET prefix-rel
prefix-val
prefix-href
http:https://datahub.rp.bt.com/cat?prefix-val=weather
http:https://datahub.rp.bt.com/cat?prefix-val=weather&pagination=true
http:https://datahub.rp.bt.com/cat?prefix-val=weather&prefix-href=http://api.bt-hypercat.com/sensors/feeds/fa899552-044a-48e2-bdbe-0076292fd4a2
Geo Bounding Box Search GET geobound-minlat
geobound-maxlat
geobound-minlong
geobound-maxlong
http:https://datahub.rp.bt.com/cat?geobound-minlat=53.395012&geobound-maxlat=53.55154&geobound-minlong=-2.394305&geobound-maxlong=-2.096988
Lexicographic Range Search GET lexrange-rel
lexrange-min
lexrange-max
http:https://datahub.rp.bt.com/cat?lexrange-rel=urn:X-hypercat:rels:lastUpdated&lexrange-min=2017-01-22T13:57:02Z&lexrange-max=2017-02-22T13:57:02Z