Toby, main reason for REST paths over query strings is typically caching. With query strings and multiple parameters, the order and presence of parameters is not deterministic. You can use ?from=something&to=somethingElse or ?to=somethingElse&from=something, which both would be separate cache entries, which is an issue if you plan to cache for longer times & purge actively.
In this particular case it should actually be fine to rely on short time caching only, which means that query parameters are an option as well. On Fri, Sep 11, 2015 at 4:46 PM, Toby Negrin <[email protected]> wrote: > This seems like a weird way to use restful URLs. Why not parameters? > > -Toby > > On Fri, Sep 11, 2015 at 4:27 PM, Gabriel Wicke <[email protected]> > wrote: > >> >> >> On Fri, Sep 11, 2015 at 4:26 PM, Gabriel Wicke <[email protected]> >> wrote: >> >>> Another option would be a single entry point >>> >>> /top/{project}/{access}/from/{start}{/end} >>> >>> with support for negative indexes for 'days in the past': >>> >>> /top/{project}/{access}/from/-30 >>> /top/{project}/{access}/from/-60/-30 >>> >>> as well as full dates: >>> >>> /top/en.wikipedia/all-access/2014-06-12/2015-08-30 >>> >> >> Correction: >> >> /top/en.wikipedia/all-access/from/2014-06-12/2015-08-30 >> >> >>> >>> >>> >>> >>> >>> >>> On Fri, Sep 11, 2015 at 3:19 PM, <[email protected]> wrote: >>> >>>> I concur with Leila. >>>> >>>> Paul >>>> >>>> >>>> --------- Original Message --------- >>>> Subject: Re: [Analytics] [Survey] Pageview API >>>> From: "Leila Zia" <[email protected]> >>>> Date: 9/11/15 3:06 pm >>>> To: "A mailing list for the Analytics Team at WMF and everybody who has >>>> an interest in Wikipedia and analytics." <[email protected] >>>> > >>>> >>>> It's getting exciting. :-) >>>> >>>> I'd go with choice 2 since it gives more control to the user while >>>> offering what the user can get through choice 1 as well. >>>> >>>> Question: will we get page_ids or page_titles or both? It's good to >>>> have both. >>>> >>>> Leila >>>> >>>> On Fri, Sep 11, 2015 at 3:00 PM, Dan Andreescu <dandreescu@wikimedia >>>> .org> wrote: >>>> >>>>> Hi everyone. End of quarter is rapidly approaching and I wanted to >>>>> ask a quick question about one of the endpoints we want to push out. We >>>>> want to let you ask "what are the top articles" but we're not sure how to >>>>> structure the URL so it's most useful to you. Here are the choices: >>>>> >>>>> Choice 1. /top/{project}/{access}/{days-in-the-past} >>>>> >>>>> Example: top articles via all en.wikipedia sites for the past 30 days: >>>>> /top/en.wikipedia/all-access/30 >>>>> >>>>> >>>>> Choice 2. /top/{project}/{access}/{start}/{end} >>>>> >>>>> Example: top articles via all en.wikipedia sites from June 12th, 2014 >>>>> to August 30th, 2015: /top/en.wikipedia/all-access/2014-06-12/2015-08-30 >>>>> >>>>> >>>>> (in all of those, >>>>> >>>>> * {project} means en.wikipedia, commons.wikimedia, etc. >>>>> * {access} means access method as in desktop, mobile web, mobile app >>>>> >>>>> ) >>>>> >>>>> Which do you prefer? Would any other query style be useful? >>>>> >>>>> _______________________________________________ >>>>> Analytics mailing list >>>>> [email protected] >>>>> https://lists.wikimedia.org/mailman/listinfo/analytics >>>>> >>>> _______________________________________________ Analytics mailing list >>>> [email protected] >>>> https://lists.wikimedia.org/mailman/listinfo/analytics >>>> >>>> >>>> _______________________________________________ >>>> Analytics mailing list >>>> [email protected] >>>> https://lists.wikimedia.org/mailman/listinfo/analytics >>>> >>>> >>> >>> >>> -- >>> Gabriel Wicke >>> Principal Engineer, Wikimedia Foundation >>> >> >> >> >> -- >> Gabriel Wicke >> Principal Engineer, Wikimedia Foundation >> >> _______________________________________________ >> Analytics mailing list >> [email protected] >> https://lists.wikimedia.org/mailman/listinfo/analytics >> >> > > _______________________________________________ > Analytics mailing list > [email protected] > https://lists.wikimedia.org/mailman/listinfo/analytics > > -- Gabriel Wicke Principal Engineer, Wikimedia Foundation
_______________________________________________ Analytics mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/analytics
