See also: http://stackoverflow.com/questions/389169/best-practices-for-api-versioning
On Thu, Aug 26, 2010 at 10:40 AM, Sebastian Benthall <[email protected]>wrote: > I'm +1 axing the full json dump for maps > > > On Thu, Aug 26, 2010 at 10:37 AM, David Winslow <[email protected]>wrote: > >> Is this a useful distinction? It seems like having a filterable listing is >> better than having a listing and a search, api-wise. In fact, we should >> probably enforce a maximum page size on the listing query either way. >> >> -d >> >> On Thu, Aug 26, 2010 at 10:31 AM, Sebastian Benthall <[email protected]>wrote: >> >>> The difference between /maps and /maps/search/api currently is that /maps >>> is a straight json dump of all the map configurations, and /maps/search/api >>> provides extra information about the search in its results and accepts query >>> parameters that are useful especially if you are trying to populate a paging >>> Extjs table with the results. >>> >>> >>> On Thu, Aug 26, 2010 at 10:27 AM, David Winslow <[email protected]>wrote: >>> >>>> What is the distinction between an API and a Search API? >>>> >>>> -d >>>> >>>> >>>> On Thu, Aug 26, 2010 at 10:22 AM, Sebastian Benthall >>>> <[email protected]>wrote: >>>> >>>>> *Proposal for 1.0:* >>>>> >>>>> /data >>>>> /data/search >>>>> /data/search/api >>>>> >>>>> /maps *<-- the only proposed change*(s) >>>>> /maps/api *<-- the only proposed change*(s) >>>>> /maps/search >>>>> /maps/search/api >>>>> >>>>> >>>>> *Alternative proposal for 1.0:* >>>>> Same as a above but dropping maps/api entirely. >>>>> >>>>> >>>>> *Speculative proposal for future release:* >>>>> >>>>> /search >>>>> /search/api >>>>> >>>>> /data >>>>> /data/api --> ??? >>>>> /data/search --> redirects to /search?flag=data >>>>> /data/search/api --> redirects to /search/api?flag=data >>>>> >>>>> /maps >>>>> /maps/api --> full json dump >>>>> /maps/search --> redirects to /search?flag=maps >>>>> /maps/search/api --> redirects to /search/api?flag=maps >>>>> >>>>> >>>>> >>>>> On Thu, Aug 26, 2010 at 10:04 AM, David Winslow >>>>> <[email protected]>wrote: >>>>> >>>>>> It would be nice to flesh this out a bit to avoid shifting URLs around >>>>>> after the 1.0 release if we can help it. >>>>>> >>>>>> -d >>>>>> >>>>>> >>>>>> On Thu, Aug 26, 2010 at 9:53 AM, Sebastian Benthall >>>>>> <[email protected]>wrote: >>>>>> >>>>>>> Currently combined maps and data search is unspecified except for "it >>>>>>> would be nice to combine maps and data search some day." >>>>>>> >>>>>>> So I suppose this doesn't interact with those plans at all. >>>>>>> >>>>>>> >>>>>>> On Thu, Aug 26, 2010 at 8:59 AM, David Winslow <[email protected] >>>>>>> > wrote: >>>>>>> >>>>>>>> How does this interact with plans to unify map search with data >>>>>>>> search? >>>>>>>> >>>>>>>> -d >>>>>>>> >>>>>>>> >>>>>>>> On Wed, Aug 25, 2010 at 9:49 PM, Ariel Nunez < >>>>>>>> [email protected]> wrote: >>>>>>>> >>>>>>>>> > I propose we change the url structure in these ways: >>>>>>>>> > /maps - overview page of GeoNode's map-related tools >>>>>>>>> (was /community ) >>>>>>>>> > /maps/api - a json dump of all map configurations >>>>>>>>> >>>>>>>>> +1 >>>>>>>>> >>>>>>>>> I thought about this issue too a couple of weeks ago, and agree >>>>>>>>> with >>>>>>>>> your proposal. >>>>>>>>> >>>>>>>>> Ariel >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>>> >>>>>>> >>>>>>> -- >>>>>>> Sebastian Benthall >>>>>>> OpenGeo - http://opengeo.org >>>>>>> >>>>>>> >>>>>> >>>>> >>>>> >>>>> -- >>>>> Sebastian Benthall >>>>> OpenGeo - http://opengeo.org >>>>> >>>>> >>>> >>> >>> >>> -- >>> Sebastian Benthall >>> OpenGeo - http://opengeo.org >>> >>> >> > > > -- > Sebastian Benthall > OpenGeo - http://opengeo.org > >
