Re: Issue about TD - how can we describe the RESTful interfaces

Hi Jonathan,

What you are describing I would call hypermedia controls, similar to forms, for describing how to interact with resources. 

There are a number of interesting serializations to look at, including Hydra, which *is* JSON-LD for describing APIs, but also HAL, RESTdesc, JSON HyperSchema, and RAML. 

Some mapping of the elements to JSON-LD is very close to what I presented for protocol bindings in August (see slide 8 in the attached ppt).

I think this is a very promising idea.

Best regards,

Michael

PS I’m sorry to not be able to be in Japan for the face to face meetings. I’m afraid I will miss the T2TRG meeting also.




On Oct 28, 2015, at 8:18 PM, 전종홍 <hollobit@etri.re.kr> wrote:

> Dear All, 
> 
> I think current our TD model[1] have some limitations. 
>  
> As you know well, WoT system should be base on the RESTful architecture and RESTful interaction model.
>  
> In RESTful model, on Description of Things, we can describe the every resources, its related HTTP command and related JSON data format. 
>  
> For example, OIC’s RAML description[2] can be support these kind of elements.  
> 
> But, current WoT IG’s TD model can’t be describe the required HTTP method and its related complex JSON input data. 
> 
> How can we solve this kind of issue ?
> How about to consider to use RAML like modeling language ? How about to consider to integrate with RAML and JSON-LD ?
> 
> Best Regards, 
> 
> — Jonathan Jeon 
> 
> [1] https://github.com/w3c/wot/blob/master/TF-TD/Tutorial.md
> [2] http://raml.org/