Resource modeling

[This page gives an overview of the Fairhair draft specification dated March 2017. While the draft reflects Fairhair’s direction and scope at the timing of writing, the content is subject to change.]

More details about Fairhair's draft specifications can be found in the acompanying White Paper

Resource Modeling specification

Fairhair specifies a common framework for resource modeling to enable each applicable ecosystem to represent its own data model according to common RESTful principles and common metadata, thus facilitating the transition to the IP and IoT domains.

In light of this, the Fairhair Resource Model defines a common RESTful interaction model to create, read, set, and delete data. In addition, it enables the harmonization of the usage of the CoAP protocol and its many options, and it specifies the usage of CBOR as the encoding format for message exchange.

Fairhair leverages the commonalities across the ecosystems to enhance interoperability and to allow the usage of common services. With this purpose, the Fairhair Resource Model standardizes names and definitions of the most common data types used across the different ecosystems, and it promotes their adoption.

The core of the Resource Model specification is represented by a superset of standardized metadata (i.e. data that provides information about other data).

Smart devices can potentially generate a vast quantity of data, however the semantic of this data is often implicit or exposed in ecosystem-specific formats. With the goal to enhance interoperability, Fairhair defines a common mechanism to annotate data and to clearly expose their semantics.

Furthermore, the Fairhair metadata model allows for ecosystem-specific extensions to address those use cases not common to all applicable protocols.