DOTA 2 Match History WebAPI(翻译)
关于DOTA 2 Match History WebAPI 的 源网页地址: http://dev.dota2.com/showthread.php?t=47115
由于源网页全英文,这边做下翻译方便以后自己及他人查阅(如有翻译不正确的地方请指正):
DOTA2现在提供匹配记录的WebAPI.。Web开发者现在可以以JSON或者XML格式,获得匹配历史记录及详情并使用在他们自己的应用中。
首先登录 http://steamcommunity.com/dev/apikey ,你将获得你的API唯一密钥,请不要在做WebAPI请求的时候泄露或被其他人查看到
以下是两个获取DOTA2匹配历史记录的API:
获得匹配历史记录:
https://api.steampowered.com/IDOTA2Match_570/GetMatchHistory/V001/?key=<key>
将<key> 替换成你自己的API密钥,这样就会以JSON形式得到最新的25场公开匹配,你也可以要求以XML格式返回通过:
https://api.steampowered.com/IDOTA2Match_570/GetMatchHistory/V001/?format=XML&key=<key>
获得最新的25场匹配. 如果想要获得更早的25场匹配记录, 请使用字段 "start_at_match_id" ,将你获得的一个match_id填入其中:(即获取以match_id作为最新一场的25场匹配历史记录)
https://api.steampowered.com/IDOTA2Match_570/GetMatchHistory/V001/?start_at_match_id=<match_id>&key=<key>
如果想要获取匹配的具体内容,使用这个API:
https://api.steampowered.com/IDOTA2Match_570/GetMatchDetails/V001/?match_id=<match_id>&key=<key>
接下来额外的字段也可以使用在获取匹配历史记录:
player_name=<name> # 通过玩家名字搜索匹配, 仅限精确匹配
hero_id=<id> # 通过特定的英雄搜索, 英雄的ID在你的DOTA安装目录 dota/scripts/npc/npc_heroes.txt 中
skill=<skill> # 0为任意 , 1为N , 2为H, 3为VH
date_min=<date> # date in UTC seconds since Jan 1, 1970 (unix time format)
date_max=<date> # date in UTC seconds since Jan 1, 1970 (unix time format)
account_id=<id> # Steam账号ID (不是Steam的登录ID, 而是数字ID)
league_id=<id> # 该联赛ID的比赛记录
start_at_match_id=<id> # 从填入的匹配记录ID开始,降序
matches_requested=<n> # 默认25场,可以改低
举个例子,获得最新的一场匹配记录:
https://api.steampowered.com/IDOTA2Match_570/GetMatchHistory/V001/?matches_requested=1&key=<key>
一起来探讨这个功能吧. 我们迫不及待的想要看到人们想出如何使用这些信息。
Please do be nice and not slam the WebAPI’s too heavily, however! Thanks!
关于WebAPI比较经常被问到的问题:
我如何根据GetMatchDetails的信息获得录像?
Replays由下面的URL组成:
http://replay<cluster>.valve.net/570/<match_id>_<replay_salt>.dem.bz2
其中 cluster, match_id 和 replay_salt 可以在GetMatchDetails中得到. 如果你好奇cluster是什么, 这是指该匹配所在的游戏服务器数据中心.
是否可以通过API获得非公开匹配的匹配记录和详情?
目前不可以. 我们正在寻找一个可能的OATUH认证系统,在能够保证玩家账号安全的情况下获取他们的匹配记录,并提供给第三方网站获取。我们希望有更多的相关信息尽快公布。
我该如何找到hero_id和item所对应的英雄和物品?
这些对应可以在你的DOTA2安装目录下被找到。
英雄:
Steam/steamapps/common/dota 2 beta/gamedota/scripts/npc/npc_heroes.txt
物品:
Steam/steamapps/common/dota 2 beta/gamedota/scripts/npc/items.txt
是否有正在进行的比赛的WebAPI?
还没有,但这真是个绝佳的想法
关于API调用次数是否有限制呢?
目前没有,但是如果匹配服务器正忙或者你频繁调用超出限制,你将可能获得503错误。请等待30秒然后重试。 因为在API开放上有个很好的经验法则就是,限制你每秒发送的请求。
来自DOTA2开发团队的更新(应该是关于当时天梯事件,而后关闭了API一段时间的通知,懒得翻了。。。)
大家注意,WebAPI现在无法访问。 What happened was that we were seeing such an overwhelming demand from people for this information that our servers were getting completely bogged down servicing all of these requests. None of the behavior we saw was malicious, there was just way too much demand and unfortunately it really started impacting the experience of general DOTA players and therefore we had to disable it for now. This is of course super interesting information and we want to make it as available to as many people as we possibly can and we are working on a couple of solutions to help greatly improve the situation so we can handle more requests, but can’t give any definitive time frame for when these will be brought online. We will keep you posted as things develop, but hopefully our solutions will let us have our cake and eat it too (after all not all cakes are a lie).
As a side note though, if people are developing against this API, make sure to implement rate limiting within your systems. We don’t have any numbers at this point, but we of course need to prevent individual accounts from submitting thousands of requests in a small window so that we can make sure that we can handle a reasonable number of users. Also if people have specific queries that they are running in large quantities that don’t naturally fit into the existing API let us know so that if it is a common request people have that the system can efficiently handle those requests.
DOTA 2 Match History WebAPI(翻译)的更多相关文章
- 你应该在开始API开发之前知道的事(下)(翻译)
放了十多天,一直在玩没写,今天终于要把坑填完了.有部分没翻,主要是一般都用不上的,有兴趣的朋友可以自己翻下. 上篇地址 :http://www.cnblogs.com/Scohura/p/357360 ...
- iptables配置——NAT地址转换
iptables nat 原理同filter表一样,nat表也有三条缺省的"链"(chains): PREROUTING:目的DNAT规则 把从外来的访问重定向到其他的机子上,比如 ...
- React Router 按需加载+服务器渲染的闪屏问题
伴随着React协议的『妥协』(v16采用MIT),React为项目的主体,这个在短期内是不会改变的了,在平时使用过程中发现了如下这个问题: 在服务器渲染的时候,刷新页面会出现闪屏的现象(白屏一闪而过 ...
- React Router 4.0 基本使用
路由的概念,起初来源于服务端,就是当浏览器访问一个网站的不同页面时,服务端能够正确的返回页面的内容.当访问首页时,它能返回首页的内容,访问关于我们页面时,返回关于我们的内容.可以看到路由就是一种控制和 ...
- 23.react-router 路由
箭头函数扩展: 箭头函数: functoin 函数名(参数){ 函数体 } 箭头函数: 1.把function删掉 , 2.参数和{}之间加上 箭头=> 简写: 1.参数的简写:只有一个参 ...
- Codeforces Round #222 (Div. 1) C. Captains Mode 状压
C. Captains Mode 题目连接: http://codeforces.com/contest/377/problem/C Description Kostya is a progamer ...
- 初学者的React全家桶完整实例
概述 该项目还有些功能在开发过程中,如果您有什么需求,欢迎您与我联系.我希望能够通过这个项目对React初学者,或者Babel/webpack初学者都有一定的帮助.我在此再强调一下,在我写的这些文章末 ...
- 第七章 : Git 介绍 (下)[Learn Android Studio 汉化教程]
Learn Android Studio 汉化教程 Let’s reset even further to remove all traces of your work on the deprecat ...
- GYM 101550 G.Game Rank(模拟)
The gaming company Sandstorm is developing an online two player game. You have been asked to impleme ...
随机推荐
- windows 10卸载自带软件
http://jingyan.baidu.com/article/14bd256e4ad268bb6c26126d.html http://jingyan.baidu.com/album/ae97a6 ...
- postgresql利用pg_upgrade升级数据库(从8.4升级到9.5)
其他见:http://my.oschina.net/ensn/blog/636766 本文利用pg_upgrade实现将8.4.18版本升级到9.5.0版本,8.4.18版本为RedHat系统自带pg ...
- Android中如何控制元素的显示隐藏?
在Android程序中,有时需要程序开启时默认隐藏某个控件,当单击某个按钮时才触发显示控件的内容.比如在查询员工资料时,提交查询后再显示查询到的表格内容: Android中控制元素的隐藏参考以下代码. ...
- 明晨HOSTS编辑器mcHostsEdtor与火狐HostAdmin配合使用
在开发过程中,需要经常切换环境开发.测试.Stage和正式环境,甚为麻烦. 后来找到了HOST切换工具mcHostsEdtor工具快速切换host,但浏览器比如有HOST缓存,后来同事推荐FireFo ...
- MySQL关键字
MySQL关键字 ADD ALL ALTER ANALYZE AND AS ASC ASENSITIVE BEFORE BETWEEN BIGINT BINARY BLOB BOTH BY CALL ...
- python之路十一
RabbitMQ基本概念RabbitMQ , 是一个使用 erlang 编写的 AMQP (高级消息队列协议) 的服务实现. 简单来说, 就是一个功能强大的消息队列服务.通常我们谈到队列服务, 会有三 ...
- python之路五
内建模块 time和datetime 在Python中,通常有这几种方式来表示时间:1)时间戳 2)格式化的时间字符串 3)元组(struct_time)共九个元素.由于Python的time模块实现 ...
- 使用jvisualvm.exe 的Btrace插件介绍/使用教程
一.背景 在生产环境中可能经常遇到各种问题,定位问题需要获取程序运行时的数据信息,如方法参数.返回值.全局变量.堆栈信息等.为了获取这些数据信息,我们可以 通过改写代码,增加日志信息的打 ...
- Fitbit Flex
Fitbit Flex 使用 7月4日,收到了在美国亚马逊上海淘的Fitbit Flex.首先谈谈这价格,在美国亚马逊上购买时的价格是98美元,下订单过后没几天,京东开始首发出售,价格定在898元.相 ...
- kali2.0中dradis的使用方法
启动脚本位于:/usr/lib/dradis下,再该目录下有一个start.sh文件,执行后,可以在浏览器中输入https://localhost:3004即可打开dradis的web接口 切记前面h ...