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"> </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"> </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_won> </current> <new_winner> <alliance id="1855"> <name>Iron Crusade</name> <ticker>Iron</ticker> </alliance> <season_won> </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
|