Skillnad mellan versioner av "TurfAPI V3"

(Usage)
(Ersätter sidans innehåll med 'Se [http://wiki.turfgame.com/en/wiki/Turf_API_V3 Turf API V3] på en engelsksspråkiga wikin. en:Turf API V3')
Rad 1: Rad 1:
== Usage ==
+
Se [http://wiki.turfgame.com/en/wiki/Turf_API_V3 Turf API V3] på en engelsksspråkiga wikin.
http://api.turfgame.com/v3
 
Will take you to a page asking you to be more specific.
 
  
'''RSS'''
+
[[en:Turf API V3]]
 
 
http://api.turfgame.com/v3/rss
 
Fetches an RSS-feed containing the 10 latest takeovers in the game.
 
 
 
http://api.turfgame.com/v3/rss/stockholm/göteborg/skåne
 
Adding regions to the url will make the rss only show takeovers from those regions.
 
 
 
http://api.turfgame.com/v3/rss/stockholm/?count=45
 
the GET-variable "antal" lets you choose the number of takeovers to be returned. maximum 100.
 
 
 
'''User'''
 
 
 
http://api.turfgame.com/v3/user/tomtebloss/drassen
 
Lets you fetch information about selected users.
 
 
 
You may also use id:xx instead of the username.
 
 
 
Example return:
 
 
 
<pre>
 
<?xml version="1.0" encoding="utf-8"?>
 
<turf>
 
  <user id="2"
 
        name="Drassen"
 
        blocktime="30"
 
        distance="51754.204360"
 
        medals="7,9,13,17,17,28,34"
 
        place="471"
 
        points="4889"
 
        pph="27"
 
        rank="31"
 
        region="Blekinge"
 
        taken="1875"
 
        takenunique="335"
 
        totalpoints="387679"
 
        zones="1377,3182,8798,9310,9353,9409,12457" />
 
  <user id="350"
 
        name="tomtebloss"
 
        blocktime="30"
 
        distance="40682.514488"
 
        medals="1,1,1,2,2,3,4,5,7,9,15,16,21,24,27,28,38,47"
 
        place="144"
 
        points="21642"
 
        pph="31"
 
        rank="47"
 
        region="Stockholm"
 
        taken="11951"
 
        takenunique="1161"
 
        totalpoints="3896847"
 
        zones="159,276,1098,7476,7477,7478,7479,7667,7831" />
 
</turf>
 
</pre>
 
 
 
If you provide a username that does not exist, you will get no return except the <turf> element.
 
 
 
'''Zones'''
 
 
 
http://api.turfgame.com/v3/zones
 
Will return all zones from the game, including pivot points. This action is demanding and is therefore subject to longer caching intervals(2 hours).
 
 
 
Example return:
 
 
 
<pre>
 
<?xml version="1.0" encoding="utf-8"?>
 
<turf>
 
  <zone lat="59.320361" lng="17.988137" points_hold="2" points_take="170" name="EssingeTorget" />
 
  <zone lat="59.317038" lng="18.002661" points_hold="2" points_take="170" name="Ulrikzone" />
 
  <zone lat="59.311601" lng="18.021929" points_hold="6" points_take="110" name="Trekantzone" />
 
  ...
 
</pre>
 
 
 
 
 
http://api.turfgame.com/v3/zones/plattan/id:3002/
 
Will return only selected zones, but with more information than the example above. You may use either the id or the name of the zone.
 
 
 
Example return:
 
 
 
<pre>
 
<?xml version="1.0" encoding="utf-8"?>
 
<turf>
 
  <zone name="Plattan"
 
        date_created="2010-09-04 16:41:37"
 
        date_taken="2012-12-05 15:18:00"
 
        lat="59.332250"
 
        lng="18.064098"
 
        points_hold="9"
 
        points_take="65"
 
        region="Stockholm"
 
        takeovers="4923"
 
        user="Pelle494"/>
 
  <zone name="SäveLanding"
 
        date_created="2011-09-04 18:36:14"
 
        date_taken="2012-12-05 15:18:00"
 
        lat="57.786081"
 
        lng="11.872128"
 
        points_hold="1"
 
        points_take="185"
 
        region="Västra götaland"
 
        takeovers="101"
 
        user="laser"
 
        blocked_seconds="238"/>
 
</turf>
 
</pre>
 
 
 
'''Stats'''
 
 
 
http://api.turfgame.com/v3/stats
 
Will return a set of updated stats from the game.
 
Example return:
 
 
 
<pre>
 
<?xml version="1.0" encoding="utf-8"?>
 
<turf zonestakentoday="3737" zonestakenyesterday="5458" zonestaken="2234384" usersthisround="1686" users="35690"/>
 
</pre>
 
[[Kategori:Tredjepartsutveckling]]
 

Versionen från 1 mars 2013 kl. 19.43

Se Turf API V3 på en engelsksspråkiga wikin.