Difference between revisions of "WebAPI/GetLiveLeagueGames"
< WebAPI
m (moved User:RJackson/WebAPI/GetLiveLeagueGames to WebAPI/GetLiveLeagueGames: Page not dun, dunno how to read tower_state bitmask and getting data to test is tough. but mainspacing) |
|||
(3 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
== URL == | == URL == | ||
<nowiki>GET http://api.steampowered.com/IDOTA2Match_<ID>/GetLiveLeagueGames/v1/</nowiki> | <nowiki>GET http://api.steampowered.com/IDOTA2Match_<ID>/GetLiveLeagueGames/v1/</nowiki> | ||
− | |||
− | |||
== Method-specific Parameters == | == Method-specific Parameters == | ||
Line 34: | Line 32: | ||
== Tower state == | == Tower state == | ||
− | + | The matches tower status is given as a 32-bit unsigned integer, with the rightmost 22 bits dictating tower state. The higher bits (leftmost) dictate the Dire team's tower status, and the lower bits (rightmost) dictate the Radiant team's tower status; within each 11bit segment, each bit represents an individual tower. See below for a visual representation. | |
− | + | ||
+ | ┌─┬─┬─┬─┬─┬─┬─┬─┬─┬───────────────────────────────────────────── Not used. | ||
+ | │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────────── Dire Ancient Top | ||
+ | │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────────── Dire Ancient Bottom | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────── Dire Bottom Tier 3 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────── Dire Bottom Tier 2 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────── Dire Bottom Tier 1 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────── Dire Middle Tier 3 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────── Dire Middle Tier 2 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────── Dire Middle Tier 1 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────── Dire Top Tier 3 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────── Dire Top Tier 2 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────── Dire Top Tier 1 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────── Radiant Ancient Top | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────── Radiant Ancient Bottom | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────── Radiant Bottom Tier 3 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────── Radiant Bottom Tier 2 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────── Radiant Bottom Tier 1 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────── Radiant Middle Tier 3 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────── Radiant Middle Tier 2 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────── Radiant Middle Tier 1 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───── Radiant Top Tier 3 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─── Radiant Top Tier 2 | ||
+ | │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─ Radiant 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 | ||
== Notes == | == Notes == | ||
<references/> | <references/> | ||
− | |||
[[Category:WebAPI|GetLiveLeagueGames]] | [[Category:WebAPI|GetLiveLeagueGames]] |
Latest revision as of 04:20, 21 October 2014
URL
GET http://api.steampowered.com/IDOTA2Match_<ID>/GetLiveLeagueGames/v1/
Method-specific Parameters
Result Data
- result
-
- games
- A list of games in-progress.
- players
- The list of players within a game.
- account_id
- 32-bit account ID.
- name
- The player's display name.
- hero_id
- The hero's unique ID. A list of hero IDs can be found via the GetHeroes method.
- team
- What team the player is currently playing as.
- 0 - Radiant
- 1 - Dire
- 2 - Broadcaster
- 4 - Unassigned
- radiant_team
- Information about the team playing as radiant for this match.
- team_name
- The team's name.
- team_id
- The team's unique ID.
- team_logo
- The UGC id for the team logo. You can resolve this with the GetUGCFileDetails method.
- complete
- Whether the players for this team are all team members.
- dire_team
- Information about the team playing as dire for this match.
- team_name
- The team's name.
- team_id
- The team's unique ID.
- team_logo
- The UGC id for the team logo. You can resolve this with the GetUGCFileDetails method.
- complete
- Whether the players for this team are all team members.
- lobby_id
- Unique ID for the matches lobby.
- spectators
- Number of spectators at time of query.
- tower_state
- See #Tower state below.
- league_id
- Unique ID for the league of the match being played. A list of league IDs can be found via the GetLeagueListing method.
Tower state
The matches tower status is given as a 32-bit unsigned integer, with the rightmost 22 bits dictating tower state. The higher bits (leftmost) dictate the Dire team's tower status, and the lower bits (rightmost) dictate the Radiant team's tower status; within each 11bit segment, each bit represents an individual tower. See below for a visual representation.
┌─┬─┬─┬─┬─┬─┬─┬─┬─┬───────────────────────────────────────────── Not used. │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────────── Dire Ancient Top │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────────── Dire Ancient Bottom │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────── Dire Bottom Tier 3 │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────── Dire Bottom Tier 2 │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────── Dire Bottom Tier 1 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────── Dire Middle Tier 3 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────── Dire Middle Tier 2 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────── Dire Middle Tier 1 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────── Dire Top Tier 3 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────── Dire Top Tier 2 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────── Dire Top Tier 1 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────── Radiant Ancient Top │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────── Radiant Ancient Bottom │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────── Radiant Bottom Tier 3 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────── Radiant Bottom Tier 2 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────── Radiant Bottom Tier 1 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────── Radiant Middle Tier 3 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────── Radiant Middle Tier 2 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────── Radiant Middle Tier 1 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───── Radiant Top Tier 3 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─── Radiant Top Tier 2 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─ Radiant 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