Difference between revisions of "Zone events"
(→Example response) |
m |
||
| Line 40: | Line 40: | ||
JSON, starting with a status message, then in the "data" key, an array containing a hash (dictionary) of each zone, with event data if any are running. | JSON, starting with a status message, then in the "data" key, an array containing a hash (dictionary) of each zone, with event data if any are running. | ||
| − | * zone: Zone name, localized (e.g., Brutwacht is in German, Brisesol is in French) | + | * zone: Zone name, localized (e.g., everything on Brutwacht is in German, Brisesol is in French) |
* zoneId: ID number for the zone. It is unknown how this number relates to the zone IDs returned by the ingame LUA API. | * zoneId: ID number for the zone. It is unknown how this number relates to the zone IDs returned by the ingame LUA API. | ||
* name: Event name, localized | * name: Event name, localized | ||
Revision as of 16:17, 14 April 2017
Contents
API endpoints
https://web-api-DC.riftgame.com/chatservice/zoneevent/list?shardId=SHARDID
DC is either us or eu.
Shard IDs
- Deepwood
- 1704
- Faeblight
- 1707
- Greybriar
- 1702
- Hailol
- 1721
- Laethys
- 1708
- Seastone
- 1701
- Wolfsbane
- 1706
- Bloodiron
- 2702
- Brisesol
- 2714
- Brutwacht
- 2711
- Gelidra
- 2721
- Typhiria
- 2741
- Zaviel
- 2722
Data returned
JSON, starting with a status message, then in the "data" key, an array containing a hash (dictionary) of each zone, with event data if any are running.
- zone: Zone name, localized (e.g., everything on Brutwacht is in German, Brisesol is in French)
- zoneId: ID number for the zone. It is unknown how this number relates to the zone IDs returned by the ingame LUA API.
- name: Event name, localized
- started: Time the event started, in seconds since Jan 1 1970 00:00. You can convert this to a human-readable date with Wolfram Alpha (input the number and "unix time"), or on a Linux command line with
date -d@THENUMBERHERE
Example response
{"status":"success","data":[{"zone":"Stillmoor","zoneId":26},{"zone":"Shimmersand","zoneId":6},{"zone":"Scarlet Gorge","zoneId":26580443,"name":"A Royal Raid","started":1492181499},{"zone":"Freemarch","zoneId":19},{"zone":"Scarwood Reach","zoneId":20},{"zone":"Ember Isle","zoneId":1992854106},{"zone":"Moonshade Highlands","zoneId":24},{"zone":"Silverwood","zoneId":12},{"zone":"Stonefield","zoneId":1481781477},{"zone":"Iron Pine Peak","zoneId":22},{"zone":"Gloamwood","zoneId":27},{"zone":"Droughtlands","zoneId":336995470},{"zone":"Kingdom of Pelladane","zoneId":479431687},{"zone":"Cape Jule","zoneId":1770829751},{"zone":"City Core","zoneId":1967477725,"name":"Entangled","started":1492179256},{"zone":"Ashora","zoneId":790513416},{"zone":"Seratos","zoneId":1494372221},{"zone":"Steppes of Infinity","zoneId":798793247},{"zone":"Ardent Domain","zoneId":1446819710},{"zone":"Eastern Holdings","zoneId":1213399942},{"zone":"Kingsward","zoneId":1300766935},{"zone":"Morban","zoneId":956914599},{"zone":"The Dendrome","zoneId":282584906},{"zone":"Draumheim","zoneId":302},{"zone":"Goboro Reef","zoneId":301},{"zone":"Tarken Glacier","zoneId":303,"name":"Tendrils of Renewal","started":1492181647},{"zone":"Tyrant\u0027s Throne","zoneId":426135797},{"zone":"Planetouched Wilds","zoneId":28},{"zone":"Gedlo Badlands","zoneId":788055204},{"zone":"Xarth Mire","zoneId":1208799201},{"zone":"Ashenfell","zoneId":2007770238},{"zone":"Scatherran Forest","zoneId":2066418614}]}
Formatted
{
"status":"success",
"data":[
{"zone":"Stillmoor","zoneId":26},
{"zone":"Shimmersand","zoneId":6},
{"zone":"Scarlet Gorge","zoneId":26580443,"name":"A Royal Raid","started":1492181499},
# SNIP
{"zone":"Scatherran Forest","zoneId":2066418614}
]
}
Interpretation
This is Wolfsbane (1706), but we can't tell that from the response. Zone events are running in Scarlet Gorge, City Core, and Tarken Glacier. In Scarlet Gorge, "A Royal Raid" started at Fri Apr 14 14:51:39 UTC 2017.
Additional Reference
Zone IDs
- Shimmersand
- 6
- Silverwood
- 12
- Freemarch
- 19
- Scarwood Reach
- 20
- Iron Pine Peak
- 22
- Moonshade Highlands
- 24
- Stillmoor
- 26
- Gloamwood
- 27
- Planetouched Wilds
- 28
- Goboro Reef
- 301
- Draumheim
- 302
- Tarken Glacier
- 303
- Scarlet Gorge
- 26580443
- The Dendrome
- 282584906
- Droughtlands
- 336995470
- Tyrant's Throne
- 426135797
- Kingdom of Pelladane
- 479431687
- Gedlo Badlands
- 788055204
- Ashora
- 790513416
- Steppes of Infinity
- 798793247
- Morban
- 956914599
- Xarth Mire
- 1208799201
- Eastern Holdings
- 1213399942
- Kingsward
- 1300766935
- Ardent Domain
- 1446819710
- Stonefield
- 1481781477
- Seratos
- 1494372221
- Cape Jule
- 1770829751
- City Core
- 1967477725
- Ember Isle
- 1992854106
- Ashenfell
- 2007770238
- Scatherran Forest
- 2066418614
Example Code
YARET Lite, a Python zone event tracker that retrieves the data from the API and constructs a Web page:
