Difference between revisions of "WebAPI/GetMatchDetails"

From Team Fortress Wiki
Jump to: navigation, search
m (Barracks Status)
m (Result data)
(15 intermediate revisions by 7 users not shown)
Line 20: Line 20:
 
::;deaths: The amount of times this player died during the match.
 
::;deaths: The amount of times this player died during the match.
 
::;assists: The amount of assists attributed to this player.
 
::;assists: The amount of assists attributed to this player.
::;leaver_status: What the values here represent are not yet known.
+
::;leaver_status:
 +
:::; 0 - NONE - finished match, no abandon.
 +
:::; 1 - DISCONNECTED - player DC, no abandon.
 +
:::; 2 - DISCONNECTED_TOO_LONG - player DC > 5min, abandoned.
 +
:::; 3 - ABANDONED - player DC, clicked leave, abandoned.
 +
:::; 4 - AFK - player AFK, abandoned.
 +
:::; 5 - NEVER_CONNECTED - player never connected, no abandon.
 +
:::; 6 - NEVER_CONNECTED_TOO_LONG - player took too long to connect, no abandon.
 
::;gold: The amount of gold the player had remaining at the end of the match.
 
::;gold: The amount of gold the player had remaining at the end of the match.
 
::;last_hits: The amount of last-hits the player got during the match.
 
::;last_hits: The amount of last-hits the player got during the match.
Line 54: Line 61:
 
:;barracks_status_dire: See [[#Barracks Status]] below.
 
:;barracks_status_dire: See [[#Barracks Status]] below.
 
:;cluster: The server cluster the match was played upon.  Used for downloading replays of matches.
 
:;cluster: The server cluster the match was played upon.  Used for downloading replays of matches.
:;first_blood_time: The time in seconds since the match began when first-blood occured.
+
:;first_blood_time: The time in seconds since the match began when first-blood occurred.
 
:;lobby_type:
 
:;lobby_type:
 
::;-1 - Invalid:
 
::;-1 - Invalid:
Line 63: Line 70:
 
::;4 - Co-op with bots.:
 
::;4 - Co-op with bots.:
 
::;5 - Team match:
 
::;5 - Team match:
 +
::;6 - Solo Queue:
 +
::;7 - Ranked:
 +
::;8 - 1v1 Mid:
 
:;human_players: The amount of human players within the match.
 
:;human_players: The amount of human players within the match.
 
:;leagueid: The league that this match was a part of.  A list of league IDs can be found via the [[WebAPI/GetLeagueListing|GetLeagueListing]] method.
 
:;leagueid: The league that this match was a part of.  A list of league IDs can be found via the [[WebAPI/GetLeagueListing|GetLeagueListing]] method.
Line 68: Line 78:
 
:;negative_votes: The number of thumbs-down the game has received by users.
 
:;negative_votes: The number of thumbs-down the game has received by users.
 
:;game_mode:
 
:;game_mode:
::;0 - All Pick:
+
::;0 - None:
::;1 - Single Draft:
+
::;1 - All Pick:
::;2 - All Random:
+
::;2 - Captain's Mode:
 
::;3 - Random Draft:
 
::;3 - Random Draft:
::;4 - Captain's Draft:
+
::;4 - Single Draft:
::;5 - Captain's Mode:
+
::;5 - All Random:
::;6 - Death Mode:
+
::;6 - Intro:
 
::;7 - Diretide:
 
::;7 - Diretide:
 
::;8 - Reverse Captain's Mode:
 
::;8 - Reverse Captain's Mode:
Line 82: Line 92:
 
::;12 - Least Played:
 
::;12 - Least Played:
 
::;13 - New Player Pool:
 
::;13 - New Player Pool:
 +
::;14 - Compendium Matchmaking:
 +
::;15 - Co-op vs Bots:
 +
::;16 - Captains Draft:
 +
::;18 - Ability Draft:
 +
::;20 - All Random Deathmatch:
 +
::;21 - 1v1 Mid Only:
 +
::;22 - Ranked Matchmaking:
 +
:;picks_bans: A list of the picks and bans in the match, if the game mode is Captains Mode.
 +
::;is_pick: Whether this entry is a pick (true) or a ban (false).
 +
::;hero_id: The hero's unique ID.  A list of hero IDs can be found via the [[WebAPI/GetHeroes|GetHeroes]] method.
 +
::;team: The team who chose the pick or ban; 0 for Radiant, 1 for Dire.
 +
::;order: The order of which the picks and bans were selected; 0-19.
 +
:;flags: ?
 +
:;engine:
 +
::;0 - Source 1:
 +
::;1 - Source 2:
 +
:;radiant_score: ?
 +
:;dire_score: ?
  
 
== Player Slot ==
 
== Player Slot ==
Line 93: Line 121:
  
 
== Tower Status ==
 
== Tower Status ==
A particular teams tower status is given as a 16-bit unsigned integer.  The first 11 bits represent individual towers belonging to that team; see below for a visual representation.
+
A particular teams tower status is given as a 16-bit unsigned integer.  The rightmost 11 bits represent individual towers belonging to that team; see below for a visual representation.
  
     ┌─────────────────────────────── Ancient Top
+
     ┌─┬─┬─┬─┬─────────────────────── Not used.
     │ ┌───────────────────────────── Ancient Bottom
+
     │ │ │ │ │ ┌───────────────────── Ancient Bottom
     │ │ ┌─────────────────────────── Top Tier 3
+
     │ │ │ │ │ │ ┌─────────────────── Ancient Top
     │ │ │ ┌───────────────────────── Top Tier 2
+
    │ │ │ │ │ │ │ ┌───────────────── Bottom Tier 3
     │ │ │ │ ┌─────────────────────── Top Tier 1
+
     │ │ │ │ │ │ │ │ ┌─────────────── Bottom Tier 2
     │ │ │ │ │ ┌───────────────────── Middle Tier 3
+
     │ │ │ │ │ │ │ │ │ ┌───────────── Bottom Tier 1
     │ │ │ │ │ │ ┌─────────────────── Middle Tier 2
+
     │ │ │ │ │ │ │ │ │ │ ┌─────────── Middle Tier 3
     │ │ │ │ │ │ │ ┌───────────────── Middle Tier 1
+
     │ │ │ │ │ │ │ │ │ │ │ ┌───────── Middle Tier 2
     │ │ │ │ │ │ │ │ ┌─────────────── Bottom Tier 3
+
     │ │ │ │ │ │ │ │ │ │ │ │ ┌─────── Middle Tier 1
     │ │ │ │ │ │ │ │ │ ┌───────────── Bottom Tier 2
+
     │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───── Top Tier 3
    │ │ │ │ │ │ │ │ │ │ ┌─────────── Bottom Tier 1
+
     │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─── Top Tier 2
    │ │ │ │ │ │ │ │ │ │ │ ┌─┬─┬─┬─┬─ Not used.
+
    │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─ Top Tier 1
 
     │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
 
     │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
 
     0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
 
     0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Line 114: Line 142:
  
 
     ┌─┬───────────── Not used.
 
     ┌─┬───────────── Not used.
     │ │ ┌─────────── Top Ranged
+
     │ │ ┌─────────── Bottom Ranged
     │ │ │ ┌───────── Top Melee
+
     │ │ │ ┌───────── Bottom Melee
 
     │ │ │ │ ┌─────── Middle Ranged
 
     │ │ │ │ ┌─────── Middle Ranged
 
     │ │ │ │ │ ┌───── Middle Melee
 
     │ │ │ │ │ ┌───── Middle Melee
     │ │ │ │ │ │ ┌─── Bottom Ranged
+
     │ │ │ │ │ │ ┌─── Top Ranged
     │ │ │ │ │ │ │ ┌─ Bottom Melee
+
     │ │ │ │ │ │ │ ┌─ Top Melee
 
     │ │ │ │ │ │ │ │
 
     │ │ │ │ │ │ │ │
 
     0 0 0 0 0 0 0 0
 
     0 0 0 0 0 0 0 0
  
[[Category:WebAPI]]
+
== Notes ==
 +
<references/>
 +
 
 +
[[Category:WebAPI|GetMatchDetails]]

Revision as of 22:02, 27 July 2016

URL

GET http://api.steampowered.com/IDOTA2Match_<ID>/GetMatchDetails/v1

Method-specific parameters

match_id (string)
Match id

Result data

result
players
List of players in the match.
account_id
32-bit account ID
player_slot
See #Player Slot below.
hero_id
The hero's unique ID. A list of hero IDs can be found via the GetHeroes method.
item_0
ID of the top-left inventory item.
item_1
ID of the top-center inventory item.
item_2
ID of the top-right inventory item.
item_3
ID of the bottom-left inventory item.
item_4
ID of the bottom-center inventory item.
item_5
ID of the bottom-right inventory item.
kills
The amount of kills attributed to this player.
deaths
The amount of times this player died during the match.
assists
The amount of assists attributed to this player.
leaver_status
0 - NONE - finished match, no abandon.
1 - DISCONNECTED - player DC, no abandon.
2 - DISCONNECTED_TOO_LONG - player DC > 5min, abandoned.
3 - ABANDONED - player DC, clicked leave, abandoned.
4 - AFK - player AFK, abandoned.
5 - NEVER_CONNECTED - player never connected, no abandon.
6 - NEVER_CONNECTED_TOO_LONG - player took too long to connect, no abandon.
gold
The amount of gold the player had remaining at the end of the match.
last_hits
The amount of last-hits the player got during the match.
denies
The amount of denies the player got during the match.
gold_per_min
The player's overall gold/minute.
xp_per_min
The player's overall experience/minute.
gold_spent
The amount of gold the player spent during the match.
hero_damage
The amount of damage the player dealt to heroes.
tower_damage
The amount of damage the player dealt to towers.
hero_healing
The amount of health the player had healed on heroes.
level
The player's level at match end.
ability_upgrades
A list detailing a player's ability upgrades.
ability
ID of the ability upgraded.
time
Time since match start that the ability was upgraded.
level
The level of the player at time of upgrading.
additional_units
Additional playable units owned by the player.
unitname
The name of the unit
item_0
ID of the top-left inventory item.
item_1
ID of the top-center inventory item.
item_2
ID of the top-right inventory item.
item_3
ID of the bottom-left inventory item.
item_4
ID of the bottom-center inventory item.
item_5
ID of the bottom-right inventory item.
season
The season the game was played in.
radiant_win
Dictates the winner of the match, true for radiant; false for dire.
duration
The length of the match, in seconds since the match began.
start_time
Unix timestamp of when the match began.
match_id
The matches unique ID.
match_seq_num
A 'sequence number', representing the order in which matches were recorded.
tower_status_radiant
See #Tower Status below.
tower_status_dire
See #Tower Status below.
barracks_status_radiant
See #Barracks Status below.
barracks_status_dire
See #Barracks Status below.
cluster
The server cluster the match was played upon. Used for downloading replays of matches.
first_blood_time
The time in seconds since the match began when first-blood occurred.
lobby_type
-1 - Invalid
0 - Public matchmaking
1 - Practise
2 - Tournament
3 - Tutorial
4 - Co-op with bots.
5 - Team match
6 - Solo Queue
7 - Ranked
8 - 1v1 Mid
human_players
The amount of human players within the match.
leagueid
The league that this match was a part of. A list of league IDs can be found via the GetLeagueListing method.
positive_votes
The number of thumbs-up the game has received by users.
negative_votes
The number of thumbs-down the game has received by users.
game_mode
0 - None
1 - All Pick
2 - Captain's Mode
3 - Random Draft
4 - Single Draft
5 - All Random
6 - Intro
7 - Diretide
8 - Reverse Captain's Mode
9 - The Greeviling
10 - Tutorial
11 - Mid Only
12 - Least Played
13 - New Player Pool
14 - Compendium Matchmaking
15 - Co-op vs Bots
16 - Captains Draft
18 - Ability Draft
20 - All Random Deathmatch
21 - 1v1 Mid Only
22 - Ranked Matchmaking
picks_bans
A list of the picks and bans in the match, if the game mode is Captains Mode.
is_pick
Whether this entry is a pick (true) or a ban (false).
hero_id
The hero's unique ID. A list of hero IDs can be found via the GetHeroes method.
team
The team who chose the pick or ban; 0 for Radiant, 1 for Dire.
order
The order of which the picks and bans were selected; 0-19.
flags
 ?
engine
0 - Source 1
1 - Source 2
radiant_score
 ?
dire_score
 ?

Player Slot

A player's slot is returned via an 8-bit unsigned integer. The first bit represent the player's team, false if Radiant and true if dire. The final three bits represent the player's position in that team, from 0-4.

   ┌─────────────── Team (false if Radiant, true if Dire).
   │ ┌─┬─┬─┬─────── Not used.
   │ │ │ │ │ ┌─┬─┬─ The position of a player within their team (0-4).
   │ │ │ │ │ │ │ │
   0 0 0 0 0 0 0 0

Tower Status

A particular teams tower status is given as a 16-bit unsigned integer. The rightmost 11 bits represent individual towers belonging to that team; see below for a visual representation.

   ┌─┬─┬─┬─┬─────────────────────── Not used.
   │ │ │ │ │ ┌───────────────────── Ancient Bottom
   │ │ │ │ │ │ ┌─────────────────── Ancient Top
   │ │ │ │ │ │ │ ┌───────────────── Bottom Tier 3
   │ │ │ │ │ │ │ │ ┌─────────────── Bottom Tier 2
   │ │ │ │ │ │ │ │ │ ┌───────────── Bottom Tier 1
   │ │ │ │ │ │ │ │ │ │ ┌─────────── Middle Tier 3
   │ │ │ │ │ │ │ │ │ │ │ ┌───────── Middle Tier 2
   │ │ │ │ │ │ │ │ │ │ │ │ ┌─────── Middle Tier 1
   │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───── Top Tier 3
   │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─── Top Tier 2
   │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─ Top Tier 1
   │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
   0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Barracks Status

A particular teams tower status is given as an 8-bit unsigned integer. The rightmost 6 bits represent the barracks belonging to that team; see below for a visual representation.

   ┌─┬───────────── Not used.
   │ │ ┌─────────── Bottom Ranged
   │ │ │ ┌───────── Bottom Melee
   │ │ │ │ ┌─────── Middle Ranged
   │ │ │ │ │ ┌───── Middle Melee
   │ │ │ │ │ │ ┌─── Top Ranged
   │ │ │ │ │ │ │ ┌─ Top Melee
   │ │ │ │ │ │ │ │
   0 0 0 0 0 0 0 0

Notes