Print Page | Close Window

03APR20 - Tournament Squares XML

Printed From: Illyriad
Category: Miscellaneous
Forum Name: Technology & data
Forum Description: Discussions on data dumps, downloads, and third party applications.
URL: http://forum.illyriad.co.uk/forum_posts.asp?TID=10788
Printed Date: 09 Dec 2021 at 11:32
Software Version: Web Wiz Forums 12.03 - http://www.webwizforums.com


Topic: 03APR20 - Tournament Squares XML
Posted By: GM Stormcrow
Subject: 03APR20 - Tournament Squares XML
Date Posted: 03 Apr 2020 at 19:27
Hi all!

We have a new XML API feed for the current list of tournament squares, with some details about them.

Tensmoor has already integrated this into Durctools, huzzah for Tens!

The URL for the XML API feed is:

https://elgea.illyriad.co.uk/external/tournamentsquaresapi" rel="nofollow - https://elgea.illyriad.co.uk/external/tournamentsquaresapi

It doesn't take any parameters, and returns the details of the tournament squares.

Frequency:  You DO NOT have to poll this xml feed regularly.

It will only change when there's a switch in tournament squares, or when a totem is chosen by an alliance.

Tournament squares will rotate at 0020UTC on:
  • 31st January - for the February (Spring) tournament
  • 30th April - for the May (Summer) tournament
  • 31st July - for an August (Fall) tournament
  • 31st October - for a November (Winter) tournament
Tournament data (in terms of totem chosen) will obv change only when a winning alliance chooses a totem.  It'll be up-to-you how regularly you poll this data, but I'd suggest hourly (in the 24h after a tournament has ended), and subsequently on a much reduced (12h/24h) basis.

The data returned should be fairly self-explanatory, and a sample is as follows:

Within a <tournament_squares> wrapper, there is multiple individual <tournament square> data:

<tournament_square id="65">
<location>
<X>-831</X>
<Y>-2476</Y>
<region id="61">
<name>Aindara</name>
</region>
<terrain_specific_type id="34">Moor</terrain_specific_type>
<terrain_combat_type id="7">Plains</terrain_combat_type>
<biome id="14">Prairie
<overall_type>No Combat Biome</overall_type>
</biome>
</location>
<totem>
<current>
<totem_type id="1">
<bonus>+5% Food</bonus>
</totem_type>
<chosen_by_alliance id="1855">
<name>Iron Crusade</name>
<ticker>Iron</ticker>
</chosen_by_alliance>
<chosen_by_player id="305935">Karl Aegis</chosen_by_player>
<chosen_datetime>2020-03-01T18:22:00.317</chosen_datetime>
<season_won>
<season id="1">
<name>Spring</name>
</season>
<year>2020</year>
</season_won>
</current>
<new_winner>
<alliance id="1855">
<name>Iron Crusade</name>
<ticker>Iron</ticker>
</alliance>
<season_won>
<season id="1">
<name>Spring</name>
</season>
<year>2020</year>
</season_won>
</new_winner>
</totem>
</tournament_square>

If there are any questions regarding this XML feed, or any issues that need addressing, please let me know.

Regards,

SC



Print Page | Close Window

Forum Software by Web Wiz Forums® version 12.03 - http://www.webwizforums.com
Copyright ©2001-2019 Web Wiz Ltd. - https://www.webwiz.net