I'd also recommend doing both. +1 to the schema proposed by Gabriel. I'm sure it'll come up eventually but, just a few thoughts:
* Both can be cached (one can be cached for <24h, the other longer). * The dynamic range allows useful linking to answer canonical questions regarding current trends. * The dynamic range can either be a redirect resolved by the web app, or it can simply do the response directly (I recommend the latter; but either can cache for <24h). It should probably specify "link rel=canonical" (HTTP header or HTML tag, for machines) with the expanded url, and in case of a UI it can advertise this as the "Permalink" (for humans). -- Timo On Sat, Sep 12, 2015 at 1:11 AM, Sage Ross <[email protected]> wrote: > And, per Tgr on Phabricator, option 2 means that urls are stable, so I > can link to some data and expect it to show the same data later on. > > -Sage > > On Fri, Sep 11, 2015 at 5:08 PM, Jonathan Morgan <[email protected]> > wrote: > > I would prefer to have both days-in-past and start/end daterange options, > > along the lines of Adam's proposal. > > > > But if I have to choose one, I concur with Leila. Start/end daterange > offers > > more functionality. > > > > Jonathan > > > > On Fri, Sep 11, 2015 at 4:44 PM, Oliver Keyes <[email protected]> > wrote: > >> > >> Big +1 to Adam. Is the top articles the first deliverable we should > >> expect? > >> > >> On 11 September 2015 at 19:27, 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 > >> >>> <[email protected]> > >> >>> 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 > >> > > >> > >> > >> > >> -- > >> Oliver Keyes > >> Count Logula > >> Wikimedia Foundation > >> > >> _______________________________________________ > >> Analytics mailing list > >> [email protected] > >> https://lists.wikimedia.org/mailman/listinfo/analytics > > > > > > > > > > -- > > Jonathan T. Morgan > > Senior Design Researcher > > Wikimedia Foundation > > User:Jmorgan (WMF) > > > > > > _______________________________________________ > > 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
