Hi Anne, Lazyweb = smartweb :-)
It is really close. I think it is missing documentation of the last development pass I made, which is 2 or 3 new methods, but everything else should be in good shape. I have made a "todo" for myself to go through this, update, and verify that everything is correct. Ethan On Sun, Jan 16, 2011 at 5:37 PM, Anne Kathrine Petterøe <[email protected]> wrote: > Ethan, > > I know this is a bit lazyweb, but you know the API2 best... > Could you please take a look at the table "Methods, Resources, and > Descriptions" here > https://cwiki.apache.org/confluence/display/ESME/API+2.0+-+Design and let me > know if that is the current status of the API? > > Thanks, > Anne > > > On 16. jan. 2011, at 13.18, Ethan Jewett wrote: > >> I think that "api" and "restapi" are the same thing, aren't they? API2 >> is both more RESTful than the original (for whatever that is worth) >> and includes streaming functionality for a few endpoints with a Jira >> ticket in the backlog to implement streaming for more endpoints. It is >> not really accurate to call it a "streaming" API because it is a full >> API for the application that includes streaming functionality where >> appropriate. >> >> The https://cwiki.apache.org/confluence/display/ESME/RESTAPI page is >> actually a copy of the original API page >> https://cwiki.apache.org/confluence/display/ESME/Google+Code+API with >> further discussion of how to convert it to a more RESTful format. This >> eventually became the "API2" >> >> Confusing enough? ;-) >> >> Here is my proposal: We keep the original API but we don't do work on >> it aside from security fixes. We add additional functionality to the >> API2 and the Twitter API going forward. We indicate that new clients >> should be developed using the API2. I should be able to support >> requests for new functionality in the API2 from client developers who >> are making use of it. I suggest we call them something like "API >> (deprecated)", "API2 (current)", and "Twitter-compatible API". >> >> I think this actually tracks quite well with what we are already >> doing. How does that sound? >> >> Ethan >> >> On Sat, Jan 15, 2011 at 4:29 PM, Anne Kathrine Petterøe >> <[email protected]> wrote: >>> Moved on to the API page: >>> http://cwiki.apache.org/confluence/display/ESME/API >>> >>> We now have four APIs: >>> api - original REST-like API >>> api2 - streaming API >>> restapi - rest API >>> twitterapi - twitter API >>> >>> or actually 5, we also have the jmx, but that's for a very specific use >>> case.. >>> >>> I think we should simplify our APIs or at least it would be great if we >>> could, because this scenario is very confusing for new users to Apache >>> ESME. It is confusing even to me actually... >>> >>> What are the current status on the different APIs? >>> Do we have any current clients which uses the original API? >>> >>> /Anne >>> >>> >>> >>> >>> >>> >>> > >
