The initial draft of the REST API specification is available now
https://community.jboss.org/wiki/GateInRESTAPISpecification.
I tried to design it as RESTful as possible for now, and we can
decide if some complexity that comes with REST is appropriate for
the GateIn REST API. For example Twitter's REST API is fairly easy
to understand, however some would not call it quite so "RESTful".
Also this specification conflicts with the stuff I've built for
GateIn Management, especially the organization of the resources
(pages, navigation, etc). However we should be in sync with how the
Public Java API is going to expose these resources. For example if I
can do api.getPages() as apposed to api.getSite().getPages() then
Pages should be a "first class resource".
All feedback is welcome.
- Nick