Rankings API

09/06/15 20:36

The Rankings API is an API extension opened for beta in May 2015. Its use is to give foreign parties, e.g. clans on TrackBase, an interface where they can gather information which are publicly available on TrackBase. With this API the users can build up their really own Tracker website showcasing information from TrackBase. So, as an example, clan XYZ could show the TB top ten players (tsp) on their homepage.
» We require you to name us with a link to our TB home page when using data from this OR any other TrackBase API

Example:

Information from & copyright at TrackBase.Net

You have to supply basic paramaters in order to get results. Currently all supported parameters are also required so that everyone knows what paramaters are possible. The following list shows short explanations for each of the possible parameters. Note that the parameters must be supplied as lower case characters.

Type: (string)
Possible are 'normal' and 'tsp'. Normal will give you the usual ranklist ordered by the actual rating, while 'tsp' gives you the ranklist ordered by the highest / lowest TSP rating.
Order: (string)
Possible are 'asc' and 'desc'. Asc will give you an ascending order, means it will start with the first rank. Simultaneously 'desc' will result in showing the lowest ranks first.
Limit: (integer)
Possible are integers in range of 1 and 50. We are currently only supporting up to 50 results to keep the loading times small.
List: (string)
Possible are 'players' and 'clans'. This is pretty much self-explanatory. Supply here whether you'd like to get the player's or clan's toplist.
Start: (integer)
Possible are all numbers greater than 0. When you supply 10 and your limit is 10, too, you will get the results from 10 to 19 when order is asc, otherwise you would receive the tenth lowest rank to the to 19th lowest rank. When you give a too high value, you may not get the exact number of results as given in the limit parameter.

Once supplied all information under following URL

https://api.trackbase.net/rankings/et.php

, you can gather all information given by us. Please note that we currently only support Wolfenstein: Enemy Territory's toplists. Other games might follow in the future.
The results are transferred via JSON. You can get information via a JavaScript AJAX request or with PHP's curl extension or any other extensions supporting gathering of online source codes.

Example request

https://api.trackbase.net/rankings/et.php?type=normal&order=asc&limit=10&list=players&start=1

We hope you like this new interface. If you do, and also if you don't, please give us feedback on the forums @ https://forum.trackbase.net/ and visit our social media web appearances for more information about TrackBase and its upcoming projects.

[ Facebook ] | [ Twitter ] | [ Google+ ]