The API relies on three members :
Public API keys only provide access to public information on the game. Access to private information may be available in the future and, in this case, will require private secret keys. However, access to private players information is subject to user's acceptance, unless existing contractual agreements.
To obtain an access key, send a simple request to firstname.lastname@example.org with details of your project, including your website URL or application name. Only non-profit projects will be authorized.
A Connector is the URL you have to call to request information. It handles the formatting of the gathered data based on your request.
At this time, only two connectors are available, both replying using UTF-8 encoding :
Connectors support at least two parameters :
apiKey(mandatory) which contains your API key,
locale(optional) which contains the locale in which the requested data will be provided (The default locale is English).
Connections represent a port from which you can gather some information.
As an example, the
server connection provides information about the server running the game, such as server time and online player count.
Connections may accept specific parameters to customize the result (for example, specific IDs or the start index and/or item-per-page count for paginated connections).
A valid request URL is composed by concatenating the following members :
The following example URL is suitable to request the JSON-formatted rarities of ID 1, 2 OR 3 in french :
This next example URL is suitable to request the JSON-formatted cards of classes' IDs 1 AND 2 (Cards which are usable by a warrior and a mage) in english :
For character's caracteristics the API accept a single value or a range of values, this URL is suitable to request the JSON-formatted list of character whose spirit value is between 2 and 4.
As another example, this example URL is suitable to request 10 JSON-formatted cards from the 10th in default locale :