Designing a good REST API, HATEOAS, etc
Designing a good REST API, HATEOAS, etc
- Subject: Designing a good REST API, HATEOAS, etc
- From: "Brook, James" <email@hidden>
- Date: Mon, 02 Apr 2012 17:56:45 +0200
- Acceptlanguage: en-US
- Thread-topic: Designing a good REST API, HATEOAS, etc
I am curious to know whether anyone has used ERRest to build a REST API that fulfills the HATEOAS part [1](hypermedia as the engine of application state) of the REST architectural style. Any real world examples that are publicly available? I am guessing that most API implementations largely miss this and force clients to construct URLs, which leads to strong coupling. I am not keen to get into an academic debate at the expensive of actually building something but it seems like a good selling point for the ERRest framework if it can in some way guide developers to build true hypermedia APIs that clients can 'discover' and that encourage loosely coupled clients.
I see that Pascal mentioned the possibility of a future presentation on HATEOAS and Atom in his WOWODC 2011 presentation on "Designing a Good Rest Service" [2].
I think perhaps the ERRest json-schema support and the HTML routing are useful for this but the wiring up of the hypermedia links and forms would not be handled by the framework.
If anyone is interested there are a couple of interesting talks on this, including one [3] where the content-type of the responses is XHTML and clients use xpath (it does make sense although I don't think I would go that way) and also another approach from Ian Robinson [4], who is using XML, Atom and XForms.
I am interested in opinions from the WOCommunity about real world REST and HATEOAS.
--
James
[1] http://en.wikipedia.org/wiki/HATEOAS
[2] http://www.slideshare.net/wocommunity/er-rest-designinggoodapi (the slides don't display in the browser, only the download link works)
[3] Jon Moore from Comcast on "Hypermedia APIs" - https://vimeo.com/20781278
[4] Ian Robinson on "Hydras and Hypermedia" - https://vimeo.com/28541275
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Webobjects-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden