Getting started with Hypercat


For machine readable access, BT CityVerve Data Hub has exposed a hypercat catalogue, which can be accessed at BT CityVerve Data Hub under /cat:
http:https://portal.bt-hypercat.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) BT CityVerve Data Hub 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://portal.bt-hypercat.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://portal.bt-hypercat.com/cat?prefix-val=weather
http:https://portal.bt-hypercat.com/cat?prefix-val=weather&pagination=true
http:https://portal.bt-hypercat.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://portal.bt-hypercat.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://portal.bt-hypercat.com/cat?lexrange-rel=urn:X-hypercat:rels:lastUpdated&lexrange-min=2017-01-22T13:57:02Z&lexrange-max=2017-02-22T13:57:02Z