Difference between revisions of "WebAPI/GetMatchDetails"
< WebAPI
(Think dis is right vOv) |
Bortsampson (talk | contribs) m (→Result data) |
||
(17 intermediate revisions by 7 users not shown) | |||
Line 9: | Line 9: | ||
:;players: List of players in the match. | :;players: List of players in the match. | ||
::;account_id: 32-bit account ID | ::;account_id: 32-bit account ID | ||
− | ::;player_slot: See [[#Player | + | ::;player_slot: See [[#Player Slot]] below. |
::;hero_id: The hero's unique ID. A list of hero IDs can be found via the [[WebAPI/GetHeroes|GetHeroes]] method. | ::;hero_id: The hero's unique ID. A list of hero IDs can be found via the [[WebAPI/GetHeroes|GetHeroes]] method. | ||
::;item_0: ID of the top-left inventory item. | ::;item_0: ID of the top-left inventory item. | ||
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: | + | ::;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 27: | Line 34: | ||
::;xp_per_min: The player's overall experience/minute. | ::;xp_per_min: The player's overall experience/minute. | ||
::;gold_spent: The amount of gold the player spent during the match. | ::;gold_spent: The amount of gold the player spent during the match. | ||
− | ::;hero_damage: The amount of damage the player | + | ::;hero_damage: The amount of damage the player dealt to heroes. |
::;tower_damage: The amount of damage the player dealt to towers. | ::;tower_damage: The amount of damage the player dealt to towers. | ||
::;hero_healing: The amount of health the player had healed on heroes. | ::;hero_healing: The amount of health the player had healed on heroes. | ||
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 | + | :;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 - | + | ::;0 - None: |
− | ::;1 - | + | ::;1 - All Pick: |
− | ::;2 - | + | ::;2 - Captain's Mode: |
::;3 - Random Draft: | ::;3 - Random Draft: | ||
− | ::;4 - | + | ::;4 - Single Draft: |
− | ::;5 - | + | ::;5 - All Random: |
− | ::;6 - | + | ::;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 | + | 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 | 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 | ||
== Barracks Status == | == Barracks Status == | ||
− | A particular teams tower status is given as an 8-bit unsigned integer. The | + | 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 | 0 0 0 0 0 0 0 0 | ||
− | [[Category:WebAPI]] | + | == Notes == |
+ | <references/> | ||
+ | |||
+ | [[Category:WebAPI|GetMatchDetails]] |
Revision as of 22:02, 27 July 2016
Contents
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