Play Now Login Create Account
illyriad
  New Posts New Posts RSS Feed - 03APR20 - Tournament Squares XML
  FAQ FAQ  Forum Search   Register Register  Login Login

03APR20 - Tournament Squares XML

 Post Reply Post Reply
Author
GM Stormcrow View Drop Down
Moderator Group
Moderator Group
Avatar
GM

Joined: 23 Feb 2010
Location: Illyria
Status: Offline
Points: 3926
Post Options Post Options   Thanks (0) Thanks(0)   Quote GM Stormcrow Quote  Post ReplyReply Direct Link To This Post Topic: 03APR20 - Tournament Squares XML
    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:


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
Back to Top
 Post Reply Post Reply
  Share Topic   

Forum Jump Forum Permissions View Drop Down

Forum Software by Web Wiz Forums® version 12.03
Copyright ©2001-2019 Web Wiz Ltd.