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 <tnegrin@wikimedia.org> 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 <gwicke@wikimedia.org> wrote:


On Fri, Sep 11, 2015 at 4:26 PM, Gabriel Wicke <gwicke@wikimedia.org> 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, <paul@paulweiss.info> wrote:
I concur with Leila.
 
Paul
 
--------- Original Message ---------
Subject: Re: [Analytics] [Survey] Pageview API
From: "Leila Zia" <leila@wikimedia.org>
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." <analytics@lists.wikimedia.org>

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
Analytics@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/analytics
_______________________________________________ Analytics mailing list Analytics@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/analytics

_______________________________________________
Analytics mailing list
Analytics@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/analytics




--
Gabriel Wicke
Principal Engineer, Wikimedia Foundation



--
Gabriel Wicke
Principal Engineer, Wikimedia Foundation

_______________________________________________
Analytics mailing list
Analytics@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/analytics



_______________________________________________
Analytics mailing list
Analytics@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/analytics




--
Gabriel Wicke
Principal Engineer, Wikimedia Foundation