python dota2数据 1 API

python dota2数据 1 比赛历史

注册API Key

https://steamcommunity.com/dev/apikey

安装dota2api

使用python的dota2api库来调用API：

pip3 install dota2api

参考文档

http://dota2api.readthedocs.io/en/latest/installation.html

获取最近5场使用英雄ID

添加API KEY：

在linux中：

export D2_API_KEY=xxxxx

也可在python文件中初始化时将KEY作为dota2api.Initialise()的参数。

查找API

查找相关函数发现查询比赛用到的函数为get_match_history()，其参数为：

account_id 包含玩家ID

hero_id 查询的对应英雄的比赛，每个英雄对应一个ID

game_mode 游戏模式

skill 水平等级

min_players 最少玩家数量

league_id 所属联赛ID

start_at_match_id 起始比赛ID

matches_requested 查询数量，默认为100

tournament_games_only 是否只包含联赛比赛

所有参数均为可选。

在这里我们需要用到的仅有account_id和matches_requested。

再查看get_matches_history()函数的返回内容：

{
num_results             - Number of matches within a single response
total_results           - Total number of matches for this query
results_remaining       - Number of matches remaining to be retrieved with subsequent API calls
[matches]               - List of matches for this response
{
match_id            - Unique match ID
match_seq_num       - Number indicating position in which this match was recorded
start_time          - Unix timestamp of beginning of match
lobby_type          - See lobby_type table
[player]            - List of players in the match
{
account_id      - Unique account ID
player_slot     - Player's position within the team
hero_id         - Unique hero ID
}
}
}

返回的是一个dictionary对象，其中最主要的是matches键，该值为一个list对象，其中包含了所查询的所有比赛信息。解析得到每一场比赛对应的dictionary，再进一步解析得到比赛的详细信息，如比赛ID，所有玩家ID和所用英雄ID。

其中matches中的players在原文档中显示为player，经测试应为players。

get_match_history.py

import dota2api
import sys
#初始化api
api = dota2api.Initialise()

#接收命令行参数
#我的dota2用户ID
my_id = sys.argv[1]
#请求的比赛场数
matches = sys.argv[2]
#调用get_match_history函数
match_history = api.get_match_history(account_id = my_id, matches_requested = matches)
#解析获得的match_history字典对象，取其中的matches键
matches = match_history['matches']
#逐个解析每场比赛
for m in matches:
#获取比赛ID
m_id = m['match_id']
#获取所有玩家
players = m['players']
#逐个解析每个玩家
for p in players:
#寻找自己
if p['account_id'] == int(my_id):
#获取所用英雄ID
h_id = p['hero_id']
break
print('match id: ', m_id, 'hero: ', h_id)