OWER-API

该版本已启用，请使用OWER-API-v2

接口规范基本无改变，可在不影响原工作环境的基础上进行迁移更新

OWER是一个基于NodeJS和Puppeteer的守望先锋2（Overwatch2）国际服玩家生涯数据获取程序、

这个项目的名字来源于Overwatch Player，于是缩写成了OWER

OWER-API

简体中文 | English

部署

要求：NodeJS V18.15.0（此版本上正常运行，其他版本未做测试）

端口默认为16524

注意：由于中国大陆的网络环境，国际服的数据获取速度可能会很慢，甚至无法获取，所以建议在国外的服务器上部署

确保部署主机上已经安装了Git，并在准备部署的目录下执行以下命令：

git clone https://github.com/kindyear/OWER-API.git

安装依赖(以Ubuntu为例)

sudo apt install libatk1.0-0 libatk-bridge2.0-0 libxkbcommon0 libxdamage1 libgbm1 libpango-1.0-0 libcairo2

然后运行项目

node app.js

不建议将端口设置为80或者其它常用端口，防止和已有服务，例如Nginx或者Apache等服务冲突，你可以使用反向代理功能将其代理到80端口或者其它你想设置的端口上

API文档

API路径为：http(s)://yourdomain.com:port/v1/api/{ROUTER}

其中将ROUTER替换为你要请求的路由接口

全局参数

apiKey：必需，用于认证访问API的访问密钥。可在项目目录/config/config.js中修改

playerTag：必需，玩家的BattleTag（战网ID），例如：KINDYEAR-1336，将#替换为-

API端点

获取玩家基础生涯信息

URL：/v1/api/PlayerInfo?{playerTag}&{apiKey}
方法：GET
响应

{
  "private": false,
  "playerBaseInfo": {
    "playerTag": "KINDYEAR-1336",
    "playerName": "KINDYEAR",
    "playerTitle": "Extraterrestrial",
    "playerIcon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/5c670baeda5a7b2ed707c940f6b17773e9fd41fe783a8810ea9283cd55d6fd43.png",
    "playerIconID": "0x02500000000068A2",
    "playerNameCardID": "0x02500000000068A2",
    "endorsementLevel": 2
  },
  "playerCompetitiveInfo": {
    "PC": {
      "Tank": {
        "playerCompetitivePCTank": "Platinum",
        "playerCompetitivePCTankTier": 2
      },
      "Damage": {
        "playerCompetitivePCDamage": "Gold",
        "playerCompetitivePCDamageTier": 2
      },
      "Support": {
        "playerCompetitivePCSupport": "Gold",
        "playerCompetitivePCSupportTier": 3
      }
    }
  },
  "currentTime": 1690110879
}

数据解释：

private：玩家是否设置了隐私，如果设置了隐私，将会返回true，否则返回false
playerBaseInfo：玩家基础信息
- playerTag：玩家的BattleTag（战网ID）
- playerName：玩家的昵称
- playerTitle：玩家的头衔
- playerIcon：玩家的头像
- playerIconID：玩家的头像ID
- playerNameCardID：玩家的名片ID
  - endorsementLevel：玩家的赞赏等级
playerCompetitiveInfo：玩家的竞技比赛信息
- PC：玩家的PC端竞技比赛信息
  - Tank：玩家的坦克信息
    - playerCompetitivePCTank：玩家的坦克段位
    - playerCompetitivePCTankTier：玩家的坦克段位等级
  - Damage：玩家的输出信息
    - playerCompetitivePCDamage：玩家的输出段位
    - playerCompetitivePCDamageTier：玩家的输出段位等级
  - Support：玩家的辅助信息
    - playerCompetitivePCSupport：玩家的辅助段位
    - playerCompetitivePCSupportTier：玩家的辅助段位等级
currentTime：当前时间戳

由于暴雪的限制，无法获取到五百强的具体排名，所有五百强的段位显示为GrandMaster-1，也就是宗师1

段位只显示当前赛季段位，无法查看之前赛季的段位

此外，暴雪似乎并没有提供开放职责的段位信息（游戏里面有但是我弄不出来），所以这里全部显示的是预设职责的段位

别问为什么没有主机，问就是没有玩主机的朋友和懒得做主机

PC平台端口数据

获取玩家快速游戏排行信息

URL：/v1/api/playerPCQuickInfo?{playerTag}&{apiKey}&{type}
方法：GET
参数：{type}：必需，请求的排行榜类型，具体参数以解释如下

`type`类型	解释说明
`time-played`	角色游戏时间
`games-won`	角色胜利场数
`weapon-accuracy`	角色武器命中率
`eliminations-per-life`	角色击杀数 / 每条生命
`critical-hit-accuracy`	角色暴击率
`multikill-best`	角色最多单次消灭
`objective-kills`	角色目标点内击杀

注释：其中目标点内击杀为玩家在目标内/附近击杀的玩家总数，包含运载目标或者目标点。此外数据排列格式为由多到少排列，具体可看响应

响应

{
  "private": false,
  "playerTag": "KINDYEAR-1336",
  "playerName": "KINDYEAR",
  "playerIcon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/7680cd5f24ef316f4218917ef5a8e8f1b9d2d39c14805c35a9a5542440464ffa.png",
  "playerIconID": "0x02500000000068A2",
  "playerNameCardID": "0x02500000000068A2",
  "gameMode": "quickPlay",
  "type": "weapon-accuracy",
  "heroRankings": [
    {
      "heroName": "Sigma",
      "heroData": "46%"
    },
    {
      "heroName": "Mei",
      "heroData": "44%"
    },
    {
      "heroName": ".......",
      "heroData": "......."
    },
    {
      "heroName": "Moira",
      "heroData": "0"
    }
  ],
  "currentTime": 1690184120150
}

数据解释：

private：玩家是否设置了隐私，如果设置了隐私，将会返回true，否则返回false
playerTag：玩家的BattleTag（战网ID）
playerName：玩家的昵称
playerIcon：玩家的头像
playerIconID：玩家的头像ID
playerNameCardID：玩家的名片ID
gameMode：游戏模式（分为quickPlay快速模式和competitive竞技模式）
type：请求的数据排行类型
heroRankings：英雄排行数据
- heroName：英雄名称
- heroData：英雄数据
- ........
currentTime：当前时间戳

获取玩家竞技游戏排行信息

URL：/v1/api/playerPCCompetitiveInfo?{playerTag}&{apiKey}&{type}
方法：GET
参数：{type}：必需，请求的排行榜类型，具体参数以解释如下

`type`类型	解释说明
`time-played`	角色游戏时间
`games-won`	角色胜利场数
`weapon-accuracy`	角色武器命中率
`win-percentage`	角色胜率（竞技模式独有）
`eliminations-per-life`	角色击杀数 / 每条生命
`critical-hit-accuracy`	角色暴击率
`multikill-best`	角色最多单次消灭
`objective-kills`	角色目标点内击杀

注释：win-percentage参数为竞技模式 独有，快速模式不可用其中目标点内击杀为玩家在目标内/附近击杀的玩家总数，包含运载目标或者目标点。此外数据排列格式为由多到少排列，响应和数据解释与快速游戏模式相似，这里不再复述。此外，竞技模式的数据只显示当前赛季的数据，无法查看之前赛季的数据。

获取玩家快速游戏英雄数据信息

URL：/v1/api/playerPCQuickHerosInfo?{playerTag}&{apiKey}&{heroID}
方法：GET
参数：{heroID}：必需，请求的英雄ID，具体的heroID和英雄名称对应表请查阅：heroID和英雄名称对应表

响应（这里以ALL HEROS为例，不同的英雄对应的数据是不相同的）

{
    "private": false,
    "playerTag": "KINDYEAR-1336",
    "playerName": "KINDYEAR",
    "playerIcon": "https://d15f34w2p8l1cc.cloudfront.net/overwatch/7680cd5f24ef316f4218917ef5a8e8f1b9d2d39c14805c35a9a5542440464ffa.png",
    "playerIconID": "0x02500000000068A2",
    "playerNameCardID": "0x02500000000068A2",
    "heroID": 0,
    "heroName": "ALL HEROES",
    "heroSourceID": "0",
    "quickHeroData": [
        {
            "categoryName": "Best",
            "categoryData": [
                {
                    "statName": "Eliminations - Most in Game",
                    "statValue": "42"
                },
                {
                    "statName": "Final Blows - Most in Game",
                    "statValue": "19"
                },
                {
                    "statName": "Healing Done - Most in Game",
                    "statValue": "18075"
                },
                {
                    "statName": "Objective Kills - Most in Game",
                    "statValue": "24"
                },
                {
                    "statName": "Objective Time - Most in Game",
                    "statValue": "06:42"
                },
                {
                    "statName": "Multikill - Best",
                    "statValue": "4"
                },
                {
                    "statName": "Solo Kills - Most in Game",
                    "statValue": "19"
                },
                {
                    "statName": "Melee Final Blows - Most in Game",
                    "statValue": "4"
                },
                {
                    "statName": "Kill Streak - Best",
                    "statValue": "22"
                },
                {
                    "statName": "Hero Damage Done - Most in Game",
                    "statValue": "19236"
                },
                {
                    "statName": "Assists - Most in Game",
                    "statValue": "30"
                },
                {
                    "statName": "Objective Contest Time - Most in Game",
                    "statValue": "05:09"
                },
                {
                    "statName": "Recon Assists - Most in Game",
                    "statValue": "14"
                }
            ]
        },
        {
            "categoryName": "Average",
            "categoryData": [
                {
                    "statName": "Hero Damage Done - Avg per 10 Min",
                    "statValue": "4747"
                },
                {
                    "statName": "Deaths - Avg per 10 Min",
                    "statValue": "4.82"
                },
                {
                    "statName": "Assists - Avg per 10 min",
                    "statValue": "11.65"
                },
                {
                    "statName": "Eliminations - Avg per 10 Min",
                    "statValue": "12.37"
                },
                {
                    "statName": "Healing Done - Avg per 10 Min",
                    "statValue": "5783"
                },
                {
                    "statName": "Objective Kills - Avg per 10 Min",
                    "statValue": "5.05"
                },
                {
                    "statName": "Objective Time - Avg per 10 Min",
                    "statValue": "01:23"
                },
                {
                    "statName": "Final Blows - Avg per 10 Min",
                    "statValue": "4.73"
                },
                {
                    "statName": "Time Spent on Fire - Avg per 10 Min",
                    "statValue": "00:32"
                },
                {
                    "statName": "Objective Contest Time - Avg per 10 Min",
                    "statValue": "00:43"
                },
                {
                    "statName": "Solo Kills - Avg per 10 Min",
                    "statValue": "0.61"
                }
            ]
        },
        {
            "categoryName": "Game",
            "categoryData": [
                {
                    "statName": "Time Played",
                    "statValue": "51:59:15"
                },
                {
                    "statName": "Games Played",
                    "statValue": "368"
                },
                {
                    "statName": "Games Won",
                    "statValue": "192"
                },
                {
                    "statName": "Games Lost",
                    "statValue": "176"
                }
            ]
        },
        {
            "categoryName": "Combat",
            "categoryData": [
                {
                    "statName": "Environmental Kills",
                    "statValue": "12"
                },
                {
                    "statName": "Multikills",
                    "statValue": "24"
                },
                {
                    "statName": "Hero Damage Done",
                    "statValue": "1480665"
                },
                {
                    "statName": "Deaths",
                    "statValue": "1504"
                },
                {
                    "statName": "Eliminations",
                    "statValue": "3858"
                },
                {
                    "statName": "Damage Done",
                    "statValue": "1480665"
                },
                {
                    "statName": "Objective Kills",
                    "statValue": "1575"
                },
                {
                    "statName": "Final Blows",
                    "statValue": "1475"
                },
                {
                    "statName": "Objective Time",
                    "statValue": "07:09:06"
                },
                {
                    "statName": "Melee Final Blows",
                    "statValue": "65"
                },
                {
                    "statName": "Time Spent on Fire",
                    "statValue": "02:44:23"
                },
                {
                    "statName": "Objective Contest Time",
                    "statValue": "03:45:18"
                },
                {
                    "statName": "Solo Kills",
                    "statValue": "189"
                }
            ]
        },
        {
            "categoryName": "Assists",
            "categoryData": [
                {
                    "statName": "Recon Assists",
                    "statValue": "81"
                },
                {
                    "statName": "Assists",
                    "statValue": "3633"
                },
                {
                    "statName": "Healing Done",
                    "statValue": "1803937"
                },
                {
                    "statName": "Defensive Assists",
                    "statValue": "2951"
                },
                {
                    "statName": "Offensive Assists",
                    "statValue": "1422"
                }
            ]
        }
    ],
    "currentTime": 1690344710459
}

数据解释：

private：玩家是否设置了隐私，如果设置了隐私，将会返回true，否则返回false
playerTag：玩家的BattleTag（战网ID）
playerName：玩家的昵称
playerIcon：玩家的头像
playerIconID：玩家的头像ID
playerNameCardID：玩家的名片ID
heroID：英雄ID
heroName：英雄名称
heroSourceID：英雄源ID（使用者不必关注此数据，该值的解释可以看后面）
quickHeroData：英雄数据
- categoryName：数据分类名称
- categoryData：数据分类数据
  - statName：数据名称
  - statValue：数据值
  - ......
  - ......
currentTime：当前时间戳

获取玩家竞技游戏英雄数据信息

URL：/v1/api/playerPCCompetitiveHerosInfo?{playerTag}&{apiKey}&{heroID}
方法：GET
参数：{heroID}：必需，请求的英雄ID，具体的heroID和英雄名称对应表请查阅：heroID和英雄名称对应表
响应于快速模式英雄数据响应相似，数据解释也相似，这里不做赘述

Console主机平台端口数据

别问，问就是没主机而且没有玩主机的好友而且懒，反正文件和路由还有代码留了主机部分的功能，未来有机会说不定会填坑

也欢迎fork或者提交支持主机的代码

部分数据解释

heroSourceID:由于不同玩家的英雄列表不相同，有可能某个玩家不玩某个英雄，导致herosData.json文件中的heroID 无法一一对应，于是在处理过程中临时内建维护了一个专属于玩家自己的heroID对应表，而heroSourceID就是当heroID 在页面上实际的ID值，而不存在的则为null值，这样就可以保证数据的准确性，同时也可以保证数据的完整性，不会因为某个英雄的数据不存在而导致数据不完整。

heroID和英雄名称对应表

heroID	英雄名称（heroName）	英雄简体中文名称
0	ALL HEROS	全部英雄
1	Ana	安娜
2	Ashe	艾什
3	Baptiste	巴蒂斯特
4	Bastion	堡垒
5	Brigitte	布里吉塔
6	Cassidy	卡西迪（永远的麦克雷）
7	D.Va	D.Va
8	Doomfist	末日铁拳
9	Echo	回声
10	Genji	源氏
11	Hanzo	半藏
12	Junker Queen	渣客女王
13	Junkrat	狂鼠
14	Kiriko	雾子
15	Lifeweaver	生命之梭
16	Lúcio	卢西奥
17	Mei	美
18	Mercy	天使
19	Moira	莫伊拉
20	Orisa	奥丽莎
21	Pharah	法老之鹰
22	Ramattra	拉玛刹
23	Reaper	死神
24	Reinhardt	莱因哈特
25	Roadhog	路霸
26	Sigma	西格玛
27	Sojourn	索杰恩
28	Soldier: 76	士兵：76
29	Sombra	黑影
30	Symmetra	秩序之光
31	Torbjörn	托比昂
32	Tracer	猎空
33	Widowmaker	黑百合
34	Winston	温斯顿
35	Wrecking Ball	破坏球
36	Zarya	查莉娅
37	Zenyatta	禅雅塔
38	Illari	伊拉锐
39	Mauga	毛加

TODO

启发 / 感谢

排名不分前后

https://zusor.io/
Linus
花散里
低调做人

免责声明

OWER项目不隶属于暴雪，也不反映暴雪或任何正式参与制作或管理《守望先锋》的人的观点或意见。Overwatch 和 Blizzard 是 Blizzard Entertainment, Inc. 的商标或注册商标。 Overwatch © Blizzard Entertainment, Inc.

其中所产生的部分数据内容版权归暴雪娱乐所有，OWER项目仅用于学习交流，不得用于商业用途。

此外，暴雪随时可能会调整数据来源网页的访问规则或者数据格式，项目不保证即时更新。

我们不保证正常运行时间、响应时间或支持。您使用此项目的风险由您自行承担。

许可证

如果满足以下条件，则允许以源代码和二进制形式重新分发和使用，无论是否经过修改：

源代码的重新分发必须保留上述版权声明、此条件列表和以下免责声明。
以二进制形式重新分发必须在随分发提供的文档和/或其他材料中复制上述版权声明、此条件列表以及以下免责声明。
未经事先书面许可，OWER 的名称及其贡献者的名称均不得用于认可或推广源自本软件的产品。

本软件由版权所有者和贡献者“按原样”提供，不承担任何明示或默示的保证，包括但不限于适销性和特定用途适用性的默示保证。在任何情况下，版权持有人或贡献者均不对任何直接、间接、附带、特殊、惩戒性或后果性损害（包括但不限于采购替代商品或服务；使用、数据或利润损失；或业务中断）承担责任因使用本软件而以任何方式引起的以及基于任何责任理论的责任，无论是合同责任、严格责任还是侵权行为（包括疏忽或其他），即使已被告知可能发生此类损害。

碎碎念

傻逼暴雪还老子国服，草

Name		Name	Last commit message	Last commit date
Latest commit History 76 Commits
.idea		.idea
config		config
data		data
docs		docs
functions		functions
node_modules		node_modules
README-eng.md		README-eng.md
README.md		README.md
app.js		app.js
package-lock.json		package-lock.json
package.json		package.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

OWER-API

部署

API文档

全局参数

API端点

获取玩家基础生涯信息

PC平台端口数据

获取玩家快速游戏排行信息

获取玩家竞技游戏排行信息

获取玩家快速游戏英雄数据信息

获取玩家竞技游戏英雄数据信息

Console主机平台端口数据

部分数据解释

heroID和英雄名称对应表

TODO

启发 / 感谢

免责声明

许可证

碎碎念

About

Releases 10

Packages

Languages

kindyear/OWER-API

Folders and files

Latest commit

History

Repository files navigation

OWER-API

部署

API文档

全局参数

API端点

获取玩家基础生涯信息

PC平台端口数据

获取玩家快速游戏排行信息

获取玩家竞技游戏排行信息

获取玩家快速游戏英雄数据信息

获取玩家竞技游戏英雄数据信息

Console主机平台端口数据

部分数据解释

heroID和英雄名称对应表

TODO

启发 / 感谢

免责声明

许可证

碎碎念

About

Topics

Resources

Stars

Watchers

Forks

Releases 10

Packages 0

Languages

Packages