API

From GodWiki
Jump to: navigation, search

API is the application programming interface where the Godville server provides programmatic access to most of the data, that can be used to write third-party programs.

The API data is available in JSON format:

http://godvillegame.com/gods/api/Godville.json

Replace 'Godville' with the name of the god.

It was previously also available in XML format via the URL http://godvillegame.com/gods/api/Godville.xml, but that format is deprecated and the XML url now returns the same JSON-format output.

By default, it is available to supply only a basic set of information about the hero of the god, about the same amount as the personal page.

The data is updated every minute, so pulling it from the server more often than that is pointless. If requests for the data are made too often (there is a limit, "no more than 30 requests per 10 minutes in a bundle (god + ip)" as a result of the incident described below) data is no longer returned about the hero and you are notified. In addition, there is an extended API but this is not available at the moment.

Controversy

Many moons ago in the first year of Godville, great controversy erupted over the discovery that certain overly-competitive guilds (who will remain unnamed here) had been using the API to effectively spy on members of other guilds (at the time, nobody knew about the API).

Since the API provides access to details normally not accessible (most notably, the health of a god's hero and their current status), members of these guilds could use the API to stalk gods (using things like the Godville chrome extension although the ability to use it to track other gods has since been removed as the API was edited by admin following the incident) and then send their heroes to the arena at the same time that the god being stalked sent their hero to the arena too, ensuring that the heroes would meet in combat. They 'farmed' players, using bots to keep track of them and having found through trial and error when certain players slept, taking advantage of this in the arena (being able to face someone who would not use any influences). This enabled the best gladiators of a guild to gang up on enemies as well as artificially inflate their number of duel wins to dominate the pantheon of gladiatorship (although some players would use alternative accounts to do this too).

A large argument ensued over whether using a tool that nobody else knew about (for a use that the admin did not know of since it was a tool they had not endorsed at all) to gain an unfair advantage over other players counted as cheating or not. Since the admin fixed the problem, it probably did count as cheating. Either way, the argument eventually fizzled out after a lot of shouting (having only got so big in the first place because most of the people involved were at the top of their guild hierarchies) as everyone got bored of it.

The argument also centered around the fact that the guilds in question had been using the API to elevate their positions in secret pantheons (in order to 'conquer' them) not visible through any other means, since it was discovered that the API let people see the positions of heroes in these hidden pantheons (they were lying dormant as remnants from the 'Russian Godville template' and those in the know reckoned they would eventually be revealed with their guilds dominating them straight away but most of them have now been officially 'revealed' anyway).

One of the main arguments is available on the forum ("Arena, challenges and more - oh my!") for anyone to see but there's not much point. It is just important that such a disregard for the stochastic and fair philosophy of the game is not repeated, but it cannot be denied that this was a very entertaining period of Godville history nevertheless.