Harici API Kılavuzu


Contents:


Introduction

These APIs expose the ability to an external website to pull data out of Voobly. E.g.: A website might want to display the top 10 rated users on a particular ladder.

As explained in Developer Membership Types an access key is required for use with this APIs. For more information on that topic please review that page

API Documentation

The following list of APIs is a limited subset of we eventually plan to expose (recorded games, team information, etc). The easiest way to get something added here if you want it is to request it on the forums.

All the APIs are located at a path like a following. Not that they all take the developer key as a parameter.
http://www.voobly.com/api/apiname?key=XXXXXXXXXXXXXX

validation

Checks whether the developer key is valid

Example URI:
http://www.voobly.com/api/validate?key=XXXXXXXXXXXXXX

Example output:
valid-key

user/$userid

Get information on a user

Example URI:
http://www.voobly.com/api/user/23?key=XXXXXXXXXXXXXX

Example output:
uid,display_name,name,account_created,last_login,****,nationid,bday,bmonth,byear,level,nation,imagelarge,imagesmall,tid
23,Elusive,Elusive,1182149865,1255417337,0,ca,1,1,1950,29,Canada,/files/view/7068/3zy8h2kp3qq5ed3is2c37nw00uw3noyo,/files/view/65009/w57tdcefdmhsz7uvc4brqxyz8dpe0tgo,


ladder/$ladderid

Get ladder information. The following example spews out the top 40 ranked players. To get a specific player add &uid=123 to the URI where 123 is the user (example #2). Other extended features:
Example URI:
http://www.voobly.com/api/ladder/10?key=XXXXXXXXXXXXXX

Example output:
rank,uid,display_name,rating,wins,losses,streak

Example URI #2:
http://www.voobly.com/api/ladder/10?key=XXXXXXXXXXXXXX&uid=23

Example output #2:
rank,uid,display_name,rating,wins,losses,streak
1,23,Elusive,1679,26,15,1

finduser/$displayname

Lookup a uid from a display name

Example URI:
http://www.voobly.com/api/finduser/elusive?key=XXXXXXXXXXXXXX

Example output:
uid
23


findusers/$displayname,$displayname2,$displayname3,...

Lookup a list of userids from a list display names

Example URI:
http://www.voobly.com/api/finduser/elusive,someuser,xmx_elite?key=XXXXXXXXXXXXXX

Example output:
name,uid
elusive,1
someuser,
xmx_elite,17


In the above example elusive and xmx_elite are valid users names. Whereas, someuser is not.


lobbies/$gameid

Lookup a list of lobbies for a game

Example URI:
http://www.voobly.com/api/lobbies/13?key=XXXXXXXXXXXXXX

Example output:
lobbyid,name,players_online,max_players,ladders

Example Usage

TODO - Post a sample PHP script

Last updated on 15/02/2015 - 17:19 by 2394823
2 Kullanıcı(lar) bu sayfayı inceliyor (30 dakika içinde)
0 üye, 2 ziyaretçi

Aktivste Beiträge der letzten Woche:
EU lobby (35 Beiträge)
RIP JJ_Fad (6 Beiträge)