Directory Description of a Thing Description
+"ref-for-dfn-wot-thing-description-directory-25">Thing Description
Directory
A.
Recent Specification Changes
-
+
+- Use
wot for well-known URI service name.
+- Refer to TD and Architecture specs for general constraints on
+secure transport.
+- Define requirements for CoAP-based TD Servers.
+- Introduction of TD Server exploration, with self-description as
+a special case.
+- Elaboration of class diagram to clarify that not all
+Directories need to be self-describing.
+- Clarify and consolidate error codes and ontology.
+- Add assertions for UTF-8 supporting internationalization.
+- Update overview figure showing introduction and exploration
+mechanisms.
+- Add Discoverer section defining requirements for discovery
+clients.
+- Use Thing Model instead of a Thing Description example for
+Directory API.
+- Refactor Directory Service API (td->thing, split anonymous
+create action, retrieve one and search as actions, listing as
+things property, split events)
- Add amplification DDOS security consideration.
- Split Security and Privacy Considerations into separate
sections.
+- Define status of search mechanisms: JSON Path, XPath, and
+SPARQL.
+- Pagination as array and pagination as collection.
+- Updates to events API.
+- TD expiry management.
+- HEAD method support.
+
+
+
+
+
- Update name of directory service to "Thing Description
Directory" with acronym TDD, to avoid confusion with the acronym TD
used for Thing Descriptions.
@@ -5891,6 +5848,12 @@ C.1
Events . Ian Hickson. W3C. 28 January 2021. W3C
Recommendation. URL: https://www.w3.org/TR/eventsource/
+[GDPR-Defs]
+General Data
+Protection Regulation (GDPR) Article 4 - Definitions.
+European Union (EU) and the European Economic Area (EEA). URL:
+https://gdpr-info.eu/art-4-gdpr/
[JSON-LD11]
JSON-LD
1.1. Gregg Kellogg; Pierre-Antoine Champin; Dave
@@ -6423,9 +6386,6 @@ § 7.3.2.3.1
-Syntactic search: JSONPath
-§ 11.3 CoRE
Resource Types Registration
diff --git a/publication/3-wd/index.html b/publication/3-wd/index.html
index 73d8b2b9..56f81735 100644
--- a/publication/3-wd/index.html
+++ b/publication/3-wd/index.html
@@ -47,7 +47,7 @@
}, {
name : "Farshid Tavakolizadeh",
w3cid : "122520",
- company : "Fraunhofer-Gesellschaft",
+ company : "formerly Fraunhofer-Gesellschaft, currently Invited Expert",
companyURL : "https://www.fraunhofer.de/"
}, {
name : "Kunihiko Toumura",
@@ -64,6 +64,11 @@
} ]
}],
localBiblio : {
+ "GDPR-Defs" : {
+ title: "General Data Protection Regulation (GDPR) Article 4 - Definitions"
+ , href: "https://gdpr-info.eu/art-4-gdpr/"
+ , publisher: "European Union (EU) and the European Economic Area (EEA)"
+ },
"OWASP-Top-10" : {
title: "OWASP Top Ten"
, href: "https://owasp.org/www-project-top-ten/"
@@ -1107,7 +1112,8 @@ Thing Description Server
A successful response from a CoAP-based TD Server providing a TD
MUST have a 2.05 (Content) status, contain a Content-Format option
- with value 432 (`application/td+json`), and the TD in the payload.
+ with value 50 (`application/json`) or 432 (`application/td+json`),
+ and the TD in the payload.
Note that the payload might be split over multiple message exchanges using
block-wise transfer [[RFC7959]].
@@ -1157,9 +1163,11 @@ Thing Description Directory
Information Model
+
As shown in [[[#exploration-class-diagram]]],
the Thing Description Directory can contain zero or more TDs.
@@ -1356,11 +1364,13 @@ Directory Service API
set in the HTTP request [[RFC7231]].
+
The APIs set the HTTP status codes as defined in
@@ -1577,9 +1587,6 @@ Creation
In particular, if `ttl` (relative expiry) is given during the creation,
such servers will calculate and store the `expires` value.
-
-
-
@@ -2089,10 +2096,12 @@ Validation
]
}
+
@@ -2170,9 +2179,11 @@ Events API
+
Event Data
@@ -2329,6 +2340,7 @@ Search API
|