CR: Web of Things (WoT) Thing Description

Web of Things (WoT) Thing Description

https://www.w3.org/TR/2019/CR-wot-thing-description-20191106/

feedback due by: 2019-11-06

Abstract

This document describes a formal model and a common representation for a Web of Things (WoT) Thing Description. A Thing Description describes the metadata and interfaces of Things, where a Thing is an abstraction of a physical or virtual entity that provides interactions to and participates in the Web of Things. Thing Descriptions provide a set of interactions based on a small vocabulary that makes it possible both to integrate diverse devices and to allow diverse applications to interoperate. Thing Descriptions, by default, are encoded in a JSON format that also allows JSON-LD processing. The latter provides a powerful foundation to represent knowledge about Things in a machine-understandable way. A Thing Description instance can be hosted by the Thing itself or hosted externally when a Thing has resource restrictions (e.g., limited memory space) or when a Web of Things-compatible legacy device is retrofitted with a Thing Description.

Status of the Document

This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/. 

The following at-risk features (marked in yellow throughout this specification) may be removed due to insufficient implementation experience reported and/or comments received during the CR period: 
 
  * Whole sections related to the security schemes described in § 5.3.3.7 CertSecurityScheme, § 5.3.3.9 PublicSecurityScheme, and § 5.3.3.10 PoPSecurityScheme. 
  * Vocabulary terms and assertions related to the implicit, password, and client flows in § 5.3.3.11 OAuth2SecurityScheme. 
  * All default values related to the above in § 5.4 Default Value Definitions. 
  * A behavioral assertion for writeallproperties that allows rejection of incomplete writes.  

This document was published by the Web of Things Working Group as a Candidate Recommendation. This document is intended to become a W3C Recommendation. 

GitHub Issues are preferred for discussion of this specification. Alternatively, you can send comments to our mailing list. Please send them to public-wot-wg@w3.org (subscribe, archives). 

W3C publishes a Candidate Recommendation to indicate that the document is believed to be stable and to encourage implementation by the developer community. This Candidate Recommendation is expected to advance to Proposed Recommendation no earlier than 4 December 2019. 

Please see the Working Group's implementation report. 

Publication as a Candidate Recommendation does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress. 

This document was produced by a group operating under the W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy. 

This document is governed by the 1 March 2019 W3C Process Document.

Received on Wednesday, 6 November 2019 09:37:55 UTC