[gatein-dev] REST API Specification

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