Difference between revisions of "User:RJackson/Dota2API"

From Team Fortress Wiki
Jump to: navigation, search
(Created page with "{{ambox | image = Pictogram info.png | contents = This API is not actively documented, under development, and not meant for public consumption. It may change at any time withou...")
 
m (Silly 1/l in monospace.)
 
(4 intermediate revisions by the same user not shown)
Line 12: Line 12:
  
 
== itemdata ==
 
== itemdata ==
Detailed data on gameplay (non-cosmetic) items.
+
Data on gameplay (non-cosmetic) items.
  
 
<pre>GET http://www.dota2.com/jsfeed/itemdata</pre>
 
<pre>GET http://www.dota2.com/jsfeed/itemdata</pre>
Line 38: Line 38:
 
:::;components: List of tokens for items combine to create this item; returns list or null.
 
:::;components: List of tokens for items combine to create this item; returns list or null.
 
:::;created: Whether the item is created from components.
 
:::;created: Whether the item is created from components.
 +
 +
== abilitydata ==
 +
Data on abilities.
 +
 +
<pre>GET http://www.dota2.com/jsfeed/abilitydata</pre>
 +
 +
=== Result data ===
 +
:;abilitydata:
 +
::;''Ability token'':
 +
:::;dname: Display name
 +
:::;affects: HTML noting target type, affected units, damage type.
 +
:::;desc:
 +
:::;dmg: HTML noting damage.
 +
:::;attrib: HTML noting ability's attributes, e.g. radius, chances, stun duration.
 +
:::;cmb: HTML noting cooldown and mana cost.
 +
:::;lore:
 +
:::;hurl: Hero URL, <code>http://dota2.com/hero/_hurl_/</code>
  
 
== heropickerdata ==
 
== heropickerdata ==
Detailed data on heroes.
+
Data on heroes intended for the hero picker.
 
<pre>GET http://www.dota2.com/jsfeed/heropickerdata</pre>
 
<pre>GET http://www.dota2.com/jsfeed/heropickerdata</pre>
  
Line 53: Line 70:
 
:::*melee
 
:::*melee
 
:::*ranged
 
:::*ranged
::;atk_1: Localized string representing attack type.
+
::;atk_l: Localized string representing attack type.
 
::;roles: List containing tokens representing hero roles.  Observed tokens:
 
::;roles: List containing tokens representing hero roles.  Observed tokens:
 
:::*Disabler
 
:::*Disabler
Line 65: Line 82:
 
:::*Pusher
 
:::*Pusher
 
:::*Jungler
 
:::*Jungler
::;roles_1: List containing strings representing hero roles.  Doesn't appear to be localized.
+
::;roles_l: List containing strings representing hero roles.  Doesn't appear to be localized.
  
 
== uniqueusers ==
 
== uniqueusers ==
Line 72: Line 89:
 
=== Result data ===
 
=== Result data ===
 
:;users_last_month:
 
:;users_last_month:
 +
 +
== heropediadata ==
 +
<pre>GET http://www.dota2.com/jsfeed/heropediadata</pre>
 +
 +
=== Parameters ===
 +
:;feeds: Known values: itemdata, herodata, abilitydata.
 +
 +
=== Result data ===
 +
==== itemdata feed ====
 +
Returns same data as  [[#itemdata]]
 +
 +
==== abilitydata feed ====
 +
Returns same data as  [[#abilitydata]]
 +
 +
==== herodata feed ====
 +
;herodata:
 +
:;''Hero token'':
 +
::;dname: Hero's display name.
 +
::;u: Hero token.
 +
::;pa: Primary attribute.  Values:
 +
:::*str:
 +
:::*int:
 +
:::*agi:
 +
::;attribs:
 +
:::;str:
 +
::::;b: Base.
 +
::::;g: Gain.
 +
:::;int:
 +
::::;b:
 +
::::;g:
 +
:::;agi:
 +
::::;b:
 +
::::;g:
 +
:::;ms: Move speed.
 +
:::;dmg: Starting damage.
 +
::::;min:
 +
::::;max:
 +
:::;armor: Starting armour.
 +
::;dac: Localized string for attack type, Melee or Ranged.
 +
::;droles: Display string for roles.
 +
 +
 +
== intlprizepool ==
 +
The current size of The International 2013's prize pool.
 +
<pre>GET http://www.dota2.com/jsfeed/intlprizepool</pre>
 +
 +
=== Result data ===
 +
:;dollars:

Latest revision as of 22:11, 2 June 2013

Rough documentation for the Dota2.com API. Data is returned in JSON format.

Global parameters

Parameters observed to be used on most methods:

l (Optional)
For localized strings; takes English name of language (none of those fancy ISO distractions).
v (Optional)
Unknown.

itemdata

Data on gameplay (non-cosmetic) items.

GET http://www.dota2.com/jsfeed/itemdata

Result data

itemdata
item token
id
img
Filename of the item's image, relative to http://media.steampowered.com/apps/dota2/images/items/
dname
Item's display name.
qual
Token representing item quality? Observed tokens:
artifact
common
component
consumable
epic
rare
secret_shop
cost
Gold cost of the item.
desc
Localized description.
attrib
HTML representing the items attributes.
mc
Mana cost
cd
Cooldown
lore
Localized item lore.
components
List of tokens for items combine to create this item; returns list or null.
created
Whether the item is created from components.

abilitydata

Data on abilities.

GET http://www.dota2.com/jsfeed/abilitydata

Result data

abilitydata
Ability token
dname
Display name
affects
HTML noting target type, affected units, damage type.
desc
dmg
HTML noting damage.
attrib
HTML noting ability's attributes, e.g. radius, chances, stun duration.
cmb
HTML noting cooldown and mana cost.
lore
hurl
Hero URL, http://dota2.com/hero/_hurl_/

heropickerdata

Data on heroes intended for the hero picker.

GET http://www.dota2.com/jsfeed/heropickerdata

Parameters

v
This parameter is required on this method, seems to accept any value.

Result data

hero token
name
Localized name.
bio
Localied bio.
atk
Token representing attack type. Observed tokens:
  • melee
  • ranged
atk_l
Localized string representing attack type.
roles
List containing tokens representing hero roles. Observed tokens:
  • Disabler
  • Nuker
  • Support
  • Escape
  • Initiator
  • LaneSupport
  • Durable
  • Carry
  • Pusher
  • Jungler
roles_l
List containing strings representing hero roles. Doesn't appear to be localized.

uniqueusers

GET http://www.dota2.com/jsfeed/uniqueusers

Result data

users_last_month

heropediadata

GET http://www.dota2.com/jsfeed/heropediadata

Parameters

feeds
Known values: itemdata, herodata, abilitydata.

Result data

itemdata feed

Returns same data as #itemdata

abilitydata feed

Returns same data as #abilitydata

herodata feed

herodata
Hero token
dname
Hero's display name.
u
Hero token.
pa
Primary attribute. Values:
  • str:
  • int:
  • agi:
attribs
str
b
Base.
g
Gain.
int
b
g
agi
b
g
ms
Move speed.
dmg
Starting damage.
min
max
armor
Starting armour.
dac
Localized string for attack type, Melee or Ranged.
droles
Display string for roles.


intlprizepool

The current size of The International 2013's prize pool.

GET http://www.dota2.com/jsfeed/intlprizepool

Result data

dollars