Difference between revisions of "Zone events"

Revision as of 18:04, 14 April 2017

API endpoints

https://web-api-DC.riftgame.com/chatservice/zoneevent/list?shardId=SHARDID

DC is either us or eu.

Shard IDs

US

Deepwood

1704

Faeblight

1707

Greybriar

1702

Hailol

1721

Laethys

1708

Seastone

1701

Wolfsbane

1706

EU

Bloodiron

2702

Brisesol

2714

Brutwacht

2711

Gelidra

2721

Typhiria

2741

Zaviel

2722

Other

Tulan

1722

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: