search

WebThingsIO / api

Web Thing API Specification
http://iot.mozilla.org/wot/
Other
164 stars 25 forks source link

Links or forms for actions? #79

Closed benfrancis closed 5 years ago

benfrancis commented 6 years ago

Siemens' latest experimental Simplified TD proposal to the WoT Working Group goes back to using links for properties and events but keeps the concept of "forms" for actions.

See https://github.com/w3c/wot-thing-description/issues/108

What do people think of using forms rather than links, but just for actions?

I personally don't see why a "form" is necessary vs. just a link to an action resource which acts as an action request queue, but forms do at least make a bit more sense for actions than for properties and events.

Note that actions are arguably different to properties and events in that they may have both arguments (input data) and a return type (output data), See #17, whereas a property and event payloads can have a single schema.

Should we continue to push for links for actions as well as actions and events, or integrate the forms proposal Siemens is proposing?

benfrancis commented 6 years ago

Lots of previous discussion on links vs. forms in https://github.com/w3c/wot-thing-description/issues/85 and https://github.com/w3c/wot-thing-description/issues/88