Wikipedia:Wiki ViewStats/API
Erscheinungsbild
URL Parameters
base url: https://tools.wmflabs.org/wikiviewstats/index.php
parameter | impact | possible values | short example(s) | default | version |
---|---|---|---|---|---|
page | page title |
|
|
-none- | 0.92 |
lang | wiki language version |
|
|
your browsers default language | 0.92 |
project or wiki |
wiki project |
|
|
wikipedia | 0.92 / 0.99 (alternative parameter name + values) |
latest 1 | query period in past days |
|
|
30 | 0.92 |
datefrom 1 | query start date |
|
|
automatically calculated | 0.1 |
dateto 1 | query end date |
|
|
automatically calculated | 0.1 |
type 2 | TOP-lists, HOT today |
|
|
-none- | 0.1 / thanks 0.98 |
locale 3 | GUI language |
|
|
your browsers default language | 0.1 |
favurl 4 | URL of wiki page where your favorites are located |
|
|
-none- | 0.95 |
section 5 | Page section where favorites are located |
|
|
-none- | 0.95 |
(1)
You can either specify latest OR datefrom (dedicated month) OR datefrom + dateto (custom). If you specify all of them - Uhm, you will see what you get.
(2)
In combination with datefrom≔0000-00-00 (today) OR datefrom≔2013-xx-00 (dedicated month). If datefrom is omitted datefrom≔0000-00-00 (today) is set automatically
(3)
Your preferred language not yet there? Feel free to act! Leave a message.
(4)
Only in combination with parameter section. See help for impact of this parameter
(5)
Only in combination with parameter favurl
Examples
Query string and parameters follow the rules of RFC 1738 and RFC 3986. The first parameter ist attached to base url with "?" sign, further parameters are attached with "&" sign.
base url: https://tools.wmflabs.org/wikiviewstats/index.php
base url + query string | result |
---|---|
https://tools.wmflabs.org/wikiviewstats/index.php?page=Star_Trek | hits of page title "Star Trek" (30 days) |
https://tools.wmflabs.org/wikiviewstats/index.php?page=Avatar_(película)&lang=es | hits of "Avatar (film)" in spanisch wikipedia (30 days) |
https://tools.wmflabs.org/wikiviewstats/index.php?page=word&lang=ru&project=d | hits of "word" in russian wiktionary (30 days) |
https://tools.wmflabs.org/wikiviewstats/index.php?type=world&lang=zh&project=% | top list of all pages in all chinese (zh) wikis (today) |
↓ for subsequent examples baseurl is not shown (you can click the link anyway) | |
?favurl=https://de.wikipedia.org/wiki/Benutzer:Hedonil§ion=Agenda | hits of user hedonil's articles (30 days) |
RESTful syntax & internal links
Alternatively it's possible to make an invocation using RESTful URI syntax – also known as "clean" URI-syntax[1]
As of version 0.99 there are 3 alternatives:
type | RESTful URI syntax | internal wiki link |
---|---|---|
1. full | https://tools.wmflabs.org/wikiviewstats/lang/wiki/latest/page | [[toollabs:wikiviewstats/de/wikipedia/30/Theodor_Fontane]] |
2. medium | https://tools.wmflabs.org/wikiviewstats/lang/wiki/page | [[toollabs:wikiviewstats/de/wikipedia/Theodor_Fontane]] |
3. short | https://tools.wmflabs.org/wikiviewstats/lang/page | [[toollabs:wikiviewstats/de/Theodor_Fontane]] |
- If a parameter is not specified, default values are set
- With this syntax only "*" as wildcard is allowed. "%" is forbidden by specification.
References
- ↑ RESTful uri design at blog.2partsmagic.com