Darkorbit Public JSON API

SO to start off with, I figure this is a good way to help promote DO by offering a publicly available JSON API to retrieve Public Player information, allowing a super-wide range of stat collection, data analysis, photo generation (signatures, etc), and so on. By creating a bridge between the public profile API and the common public, BP can help expand Darkorbit much further than the game is currently in. So without further ado, I present the DJA. Plus given how much the new client uses JSON I'm sure somebody will love the task.

The API would look something like the following



uid: Integer, values: Infinite - Player UID (used to retrieve JSON data).
server: String, values: Server ID

Player Object:
profile: Integer, values: 0 - Private, JSON file encoded and sent, 1 - public, (0 by default and for banned players)
name: String, values: Player Name
status: Integer, values: 0 - Private, 1 - Online, 2 - Offline (0 by default)
title: String, values: null, Title
profile_pic: Not integrated
rank: Integer, values: 1 - 20 (Basic Space Pilot -> General)
level: Integer, values: 1 - ? (Player Level)
company: Integer, values: 1, 2, 3 (MMO, EIC, VRU)
member_since: String, values: "date_string"
hours: Integer, values: 0 - ? (Total Player Hours)
achievements: Integer, values: 0 - max (Player Achievements)
bio_points: Integer, values: 0 - 50 (Points Used)
ship_type: Integer, values: 1 - 11 (Phoenix - Citadel?)
ship_design: Integer, values: 1 - ? (Ship Design ID)
drone_top: String, values: "Iris", "Flax", "Aegis", "Zeus" (I think)
drone_top_level: Integer, values: 1 - 6 (Drone level)
drone_design: Integer, values: 0, 1, 2 (None, Havok, Hercules)
pet_level: Integer, values: 0 - 15 (No Pet to Max Level pet).

Feel free to make any suggestions, comments

 

Don't see why not, there's a lot of games that do it, especially popular in MMOs. They would probably make it something where the player had to agree to their stats being public and so on, however they could extend it out to things like total credits earned or all damage ever done. Could end up being really interesting, especially since it would be an effective leader board that would span all servers.

Would be great to have public API of clans as well to see things like the clan that has killed the most CBS in whole of DO etc.

 

Actually thinking of going more in depth when I get some time to get an example of a ranking API. Basically if it's public, no reason why there shouldn't be an easy to use API to get data from (provided it's hosted independently to prevent usage abuse and attacks).

As for privacy, the profile object contains possible returned values: 0 for private (0 will be default), and 1, which indicates the profile is public and will contain with the object list

Through further analysis it's currently mostly possible currently if provided a profile URL. Requires a bit of work to retrieve all the elements though so currently it seems a more public API makes sense.

 

Note: The thread will be re-opened only if the OP requests for it.

Enjoy the game.

Closing due to inactivity.