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