切换主题
英雄列表与战力查询 API
这里介绍 HaiYang助手的两个公开接口：英雄列表与战力查询。先获取英雄 ID，再按英雄和平台查询地区门槛，下面的示例可直接用于发起请求。
接口域名：https://wz.hay7.cn。请求方式为 GET，返回为 JSON，业务成功码为 code: 0。
公开接口状态
正在读取接口状态…
一、英雄列表
获取全部英雄的 ID、名称、称号与内部名，无需业务参数。
接口地址：GET https://wz.hay7.cn/api/v1/heroes
bash
curl "https://wz.hay7.cn/api/v1/heroes"查看返回示例（英雄列表仅节选两项，数值与时间均为示例）
json
{
"code": 0,
"msg": "ok",
"data": [
{
"hero_id": 105,
"hero_name": "廉颇",
"hero_title": "正义爆轰",
"id_name": "lianpo"
},
{
"hero_id": 106,
"hero_name": "小乔",
"hero_title": "恋之微风",
"id_name": "xiaoqiao"
}
],
"meta": {
"date": "2026-09-14",
"days": 2,
"heroes": 132,
"regions": 2337,
"updated_at": "2026-09-14 18:44:22",
"stamp": 1789382662,
"src": "王者荣耀官方战力地区数据",
"version": "1.0.0",
"notice": "HaiYang助手 · 王者战力查询 API ｜ 微信 haiyang_696"
}
}二、战力查询
查询一个英雄在省、市、区县各层级中，门槛最低的若干地区。
接口地址：GET https://wz.hay7.cn/api/v1/power
| 参数 | 必填 | 说明 |
|---|---|---|
hero | 是 | 英雄 ID 或准确名称，如 111、孙尚香 |
platform | 否 | aqq 安卓QQ、iqq 苹果QQ、awx 安卓微信、iwx 苹果微信；不传返回四个平台 |
top | 否 | 每个层级返回的地区数，1～10，默认 5 |
level | 否 | province 省、city 市、county 区县；不传返回三层 |
示例查询孙尚香在安卓 QQ 的战力，每个层级返回最低的一个地区：
bash
curl "https://wz.hay7.cn/api/v1/power?hero=111&platform=aqq&top=1"查看完整返回示例（数值与时间均为示例）
json
{
"code": 0,
"msg": "ok",
"data": {
"heroId": 111,
"heroName": "孙尚香",
"platforms": {
"aqq": {
"name": "安卓QQ",
"updatetime": "2026-09-14 18:31:52",
"national": {
"rank1": 19996,
"top10": 17489,
"top100": 15708,
"top1Name": "小遇",
"top1Role": "非凡王者",
"date": "2026-09-16"
},
"province": [
{
"rank": 1,
"adcode": 220000,
"region": "吉林省",
"power": 9009
}
],
"city": [
{
"rank": 1,
"adcode": 511900,
"region": "巴中市",
"power": 2000
}
],
"county": [
{
"rank": 1,
"adcode": 360322,
"region": "上栗县",
"power": 1000
}
],
"date": "2026-09-16",
"stale": false
}
}
},
"meta": {
"date": "2026-09-14",
"days": 2,
"heroes": 132,
"regions": 2337,
"updated_at": "2026-09-14 18:44:22",
"stamp": 1789382662,
"src": "王者荣耀官方战力地区数据",
"version": "1.0.0",
"notice": "HaiYang助手 · 王者战力查询 API ｜ 微信 haiyang_696"
}
}rank=1 表示该层级门槛最低的地区，power 是上榜门槛。date 是数据日期，updatetime 是该平台的数据更新时间；stale 为 true 时表示数据较旧。national 没有记录时为 null。
调用说明
- 先检查业务结果：HTTP 200 不一定表示查询成功，请同时检查
code和msg。 - 合理控制频率：请求过于频繁时会返回
429，请按响应头Retry-After提示等待后重试。 - 适当缓存结果：建议在服务端调用，英雄列表无需每次查询都重新拉取，同一英雄的查询结果也可以短时间复用。
- 留意数据日期：榜单会随游戏内数据变化，接口展示的是已收录记录，最终以游戏内榜单和结算为准。
遇到查询异常，请附上接口路径、英雄、平台、HTTP 状态码和错误信息，方便我们定位。