王者荣耀英雄战力查询接口文档

浅风叶落

于 2025-04-26 20:08:43 发布

阅读量268

点赞数 5

分类专栏：王者荣耀文章标签：王者荣耀

本文链接：https://blog.csdn.net/cs13797778767/article/details/147541782

版权

王者荣耀专栏收录该内容

2 篇文章

订阅专栏

在线演示地址：https://wx.wrtt.top/wzry/

1. 接口概述

1.1 接口名称

王者荣耀英雄战力查询接口

1.2 接口功能

查询指定英雄的荣耀战力数据，包括：
- 全国排名（第100名、第10名战力）
- 省级金牌称号最低战力（前10名省份）
- 市级银牌称号最低战力（前10名城市）
- 县级铜牌称号最低战力（前10名区县）

1.3 适用场景

游戏玩家查询英雄战力排名
数据分析（如战力分布、地区差异）
游戏社区战力排行榜展示

2. 接口地址

https://api.wzryqz.cn/gethero

3. 请求方式

GET

4. 请求参数

参数名	类型	是否必填	示例值	说明
`hero`	`string`	✅	`张良`	英雄名称（支持中文）
`type`	`string`	✅	`aqq`	数据类型（`aqq`/`awx`/`iqq`/`iwx`）

参数说明

hero：英雄名称（如“张良”、“李白”）
type：
- aqq：安卓QQ区
- awx：安卓微信区
- iqq：iOS QQ区
- iwx：iOS 微信区

5. 返回结果

5.1 成功响应（HTTP 200）

{
    "heroId": 105,
    "name": "廉颇",
    "photo": "https://game.gtimg.cn/images/yxzj/img201606/heroimg/105/105.jpg",
    "hero_type": "坦克",
    "platform": "aqq",
    "updatetime": "2025-04-26 19:52:29",
    "Top10": "12764",
    "Top100": "10564",
    "province": [
        {
            "loc": "台湾省",
            "val": 6542
        },
        {
            "loc": "宁夏回族自治区",
            "val": 6788
        },
        ...
    ],
    "city": [
        {
            "loc": "辽宁省铁岭市",
            "val": 4409
        },
        {
            "loc": "新疆维吾尔自治区哈密市",
            "val": 4435
        },
        ...
    ],
    "county": [
        {
            "loc": "黑龙江省齐齐哈尔市昂昂溪区",
            "val": 1020
        },
        {
            "loc": "陕西省汉中市佛坪县",
            "val": 1035
        },
        ...
    ]
}

6. 字段说明

字段	类型	说明
`heroId`	`int`	英雄ID
`name`	`string`	英雄名称
`photo`	`string`	英雄头像URL
`hero_type`	`string`	英雄职业（如“坦克”、“法师”）
`platform`	`string`	数据来源（`aqq`/`awx`/`iqq`/`iwx`）
`updatetime`	`string`	数据更新时间
`Top10`	`string`	全国第10名战力
`Top100`	`string`	全国第100名战力
`province`	`array`	省级金牌称号最低战力（前10名）
`city`	`array`	市级银牌称号最低战力（前10名）
`county`	`array`	县级铜牌称号最低战力（前10名）

7. 请求示例

7.1 查询张良在安卓QQ区的战力数据

GET https://api.wzryqz.cn/gethero?hero=张良&type=aqq HTTP/1.1
Host: api.wzryqz.cn

7.2 查询李白在iOS微信区的战力数据

GET https://api.wzryqz.cn/gethero?hero=李白&type=iwx HTTP/1.1
Host: api.wzryqz.cn

8. 注意事项

参数校验：
- hero 和 type 必须提供，否则返回 400 错误。
- hero 需为有效英雄名称（如“张良”、“李白”）。
- type 必须为 aqq/awx/iqq/iwx 之一。
数据更新：
数据每日凌晨更新一次，建议每日调用一次获取最新数据。