GK Aion API details

Current version: 0.25 - See version history at the bottom of this page for more details.

One of our membes has developed a simple API to use for obtaining details about characters or legions from within Aion. The API, written in PhP, uses basic html-parsing to obtain all of the requested details from the Aion website. Details of it's use are below.

v0.25 - Substantial update to deal with extra data fields in the new HTML layout

Since the last time I played Aion, NCSoft have made substantial changes to the HTML layout of their character pages. This update to the Aion API corrects the errors that this introduced and adds new fields where they have been created. The new data now available is:

v0.22 - Adding JSONP functionality

The latest version of the GK Aion API now supports the generation of JSONP. If you'd like to make use of this functionality, simply pass the name of the callback function you wish to use on the URL request as the parameter "callback". For example:

http://www.griffonknight.com/AionAPI/request.php?type=C&server=Telemachus&element=Greyshade&rtnType=J&callback=functionname

This will return the JSON encoded data wrapped in a call to the function "functionname".

AionRunnerSlim - Leveraging the GK Aion API

Zaephor of the Ariel server has built a cool little VB app which leverages the API to create a very small in-game search function. For more details have a look at this page.

Important points:

Use of the API:

Using the following URL you can obtain information about an individual character or a legion within Aion:

http://www.griffonknight.com/AionAPI/request.php?type=<1>&server=<2>&element=<3>&rtnType=<4>

WHERE:

  1. "C" for Character request or "L" for Legion.
  2. Name of the server (eg. Telemachus)
  3. Name of character or legion (Note that the api will try to match a single entry for what you pass in here. If a single match is found it will return results, if not it will fail).
  4. Return information type: "X" for XML or "J" for a JSON encoded array.

 

An example in PHP:

You can see a more detailed example of how a very simple Legion Roster page can be generated using PHP and HTML here:

http://www.griffonknight.com/hostedfiles/AionAPIexample.php

Example data:

You can see detailed examples of the data returned by the API here:

http://www.griffonknight.com/hostedfiles/AionAPIexampleData.php

Using the mini-popup view:

If you would like to use an "in-game" version of the lookup tool you'll need to do the following:

Version history: