diff --git a/index.html b/index.html index b68febe1..a0861c44 100644 --- a/index.html +++ b/index.html @@ -1514,7 +1514,7 @@

Creation

Creation refers to the registration of a new TD inside the directory.

- The TD object is validated in accordance with [[[#validation]]]. + The TD object is validated in accordance with [[[#exploration-directory-api-things-validation]]]. Note that a TD may or may not be generated by the Thing it describes. For brownfield devices in particular a separate Discoverer process or service may be required that generates and registers a TD for a Thing @@ -1536,7 +1536,7 @@

Creation

The request SHOULD contain `application/td+json` Content-Type header for JSON serialization of TD. - The TD object is validated in accordance with [[[#validation]]]. + The TD object is validated in accordance with [[[#exploration-directory-api-things-validation]]]. Upon successful processing, the server MUST respond with 201 (Created) status. @@ -1558,7 +1558,7 @@

Creation

The request SHOULD contain `application/td+json` Content-Type header for JSON serialization of TD. - The TD object is validated in accordance with [[[#validation]]]. + The TD object is validated in accordance with [[[#exploration-directory-api-things-validation]]]. Upon successful processing, the server MUST respond with 201 (Created) status and a Location header containing a system-generated identifier for the TD. @@ -1719,7 +1719,7 @@

Update

The request SHOULD contain `application/td+json` Content-Type header for JSON serialization of TD. - The TD object is validated in accordance with [[[#validation]]]. + The TD object is validated in accordance with [[[#exploration-directory-api-things-validation]]]. Upon success, the server MUST respond with 204 (No Content) status. @@ -1763,7 +1763,7 @@

Update

but appear in the original TD, that member is removed. Members with object values are processed recursively. - After applying the modifications, the TD object is validated in accordance with [[[#validation]]]. + After applying the modifications, the TD object is validated in accordance with [[[#exploration-directory-api-things-validation]]]. Upon success, the server MUST respond with a 204 (No Content) status. @@ -2033,16 +2033,22 @@

Listing

-
+

Validation

The syntactic validation of TD objects before storage is RECOMMENDED to prevent common erroneous submissions. + - The server MAY use - Thing Description JSON Schema - to validate standard TD vocabulary, or a more comprehensive JSON Schema to also validate extensions. + The server SHOULD use at least + Minimal Validation + as defined in [[wot-thing-description11]] + to validate TDs, including use of the + WoT Thing Description (1.0) JSON Schema or + WoT Thing Description 1.1 JSON Schema, + and the JSON schema defined in [[[#tdd-extensions-jsonschema]]] for Enriched TDs, + as appropriate based on the value of the @context.

Additional forms of validation can be added to support various use cases. @@ -2092,10 +2098,6 @@

Validation

due to the current lack of WoT-specific error types.

- - - -
@@ -2401,9 +2403,8 @@

API Specification (Thing Model)

given in this Thing Model are not normative and are provided for information only.

-
-                        
-
+

 
                     

Need to confirm if equivalent OpenAPI spec can be easily created out of the TM. @@ -2964,6 +2965,15 @@

CoRE Resource Types Registration

+ +
+

JSON Schema for WoT Discovery TD-extensions

+ The following JSON Schema specifies the extensions used in Enriched TDs. + It can be used for validating TDs by a TDD + as prescribed in [[[#exploration-directory-api-things-validation]]]. +

+    

Recent Specification Changes