[rest-practices] text/html representation?

[Bob McWhirter]

I've certainly created HTML and <form>-centric representations and  
helpers before.

I think the next one I create will be a purely HTML UI, but rely on  
fondling JSON to actually do anything of note.  No reason to do extra  
work to support POST'd <form>s and such, when we have a perfectly  
usable JSON-centric API just waiting to be consumed.

Plus, you get "using X service from javascript with json" examples  
"for free".

	-Bob


On Apr 27, 2010, at 4:23 PM, Mark McLoughlin wrote:

> Hey,
>
> I was trying to think of some simple advice for people designing REST
> APIs - things like "if you're documenting the URI scheme, it's not
> HATEOAS"
>
> Would it be a worthwhile exercise for API designers to add a text/html
> representation of their resources? with forms for action buttons etc.
>
> That way you could be confident your really API is hypertext driven.  
> It
> would also be a nice way for API users to browse the API
>
> Just a thought ...
>
> Cheers,
> Mark.
>
> _______________________________________________
> rest-practices mailing list
> rest-practices at redhat.com
> https://www.redhat.com/mailman/listinfo/rest-practices