王者战力查询

wzryGET
GEThttps://v1.apizero.cn/api/wzry
获取 API Key工作台购买 / 调试

概述

王者荣耀全国战力查询，一接口聚合「英雄列表 + 区服战力分布」2 大功能。 • action=heroes — 返回 130+ 个英雄完整目录（中文名 / ename / 称号 / 头像 URL），优先腾讯官方源 https://pvp.qq.com/web201605/js/herolist.json • action=query — 查询某英雄在某区服的全国战力分布数据，返回 90 条左右的省市区战力榜（含同地区相近排名） 支持 4 大区服： · aqq = Android QQ · awx = Android 微信 · iqq = iOS QQ · iwx = iOS 微信 查询类型： · all = 完整 heroList（按 level 混合排列，约 90 项） · min = 各级（省/市/区）最低战力 + 相近排名（rank ≤ +100） · max = 各级（省/市/区）最高战力 + 相近排名

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/wzry/raw.md
打开 Markdown

鉴权

匿名每日 50 次、QPS 2；登录用户每日 200 次、QPS 5（全部免费）。英雄列表缓存 24h、战力数据缓存 1h。

获取 API Key

请求头

Authorizationstring选填

推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

英雄列表

GETURL QUERY·APPLICATION/JSON

返回全部英雄 list（name / title / ename / avatar）。ename 即后续 query 的 hero_id。文档示例为真实抓取（仅展示前几条）。

https://v1.apizero.cn/api/wzry?action=heroes

action（操作）string必填

固定 heroes

例heroes

返回结果

actionstring

heroes

countinteger

英雄总数

listarray

英雄列表：name / title / ename / avatar

namestring

名称

titlestring

标题

enamestring

ename

avatarstring

avatar

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "action": "heroes",
    "count": 131,
    "list": [
      {
        "name": "廉颇",
        "title": "正义爆轰",
        "ename": "105",
        "avatar": "https://game.gtimg.cn/images/yxzj/img201606/heroimg/105/105.jpg"
      },
      {
        "name": "小乔",
        "title": "恋之微风",
        "ename": "106",
        "avatar": "https://game.gtimg.cn/images/yxzj/img201606/heroimg/106/106.jpg"
      },
      {
        "name": "赵云",
        "title": "苍天翔龙",
        "ename": "107",
        "avatar": "https://game.gtimg.cn/images/yxzj/img201606/heroimg/107/107.jpg"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

战力查询

GETURL QUERY·APPLICATION/JSON

按英雄 + 区服查询战力分布。hero 与 hero_id 二选一。文档示例为赵云 / Android QQ 真实抓取（rank_data 已截断）。

https://v1.apizero.cn/api/wzry?action=query&hero=%E8%B5%B5%E4%BA%91&hero_id=107&zone=aqq&type=all

action（操作）string必填

固定 query

例query

herostring选填

英雄中文名

例赵云

hero_idinteger选填

英雄 ename，优先级高于 hero

例107

zonestring必填

aqq / awx / iqq / iwx

例aqq

type（类型）string选填

all / min / max

例all

返回结果

heroobject

英雄信息：name / title / ename / avatar

namestring

名称

titlestring

标题

enamestring

ename

avatarstring

avatar

zoneobject

区服：code / system / platform

codestring

code

systemstring

system

platformstring

平台

rank_dataarray

各地区战力/排名条目

addressstring

address

levelstring

level

adcodestring

adcode

ranknumber

rank

syn_datestring

数据同步日期

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "action": "query",
    "hero": {
      "name": "赵云",
      "title": "苍天翔龙",
      "ename": "107",
      "avatar": "https://game.gtimg.cn/images/yxzj/img201606/heroimg/107/107.jpg"
    },
    "zone": {
      "code": "aqq",
      "system": "Android",
      "platform": "QQ"
    },
    "type": "全部",
    "type_code": "all",
    "syn_date": "2026-07-30",
    "rank_data": [
      {
        "address": "内蒙古",
        "level": "province",
        "adcode": "2082639256508563456",
        "rank": 9577
      },
      {
        "address": "青海",
        "level": "province",
        "adcode": "2082639256507777024",
        "rank": 9601
      },
      {
        "address": "中国澳门",
        "level": "province",
        "adcode": "2082639256514805760",
        "rank": 9601
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/wzry?action=query&hero=%E8%B5%B5%E4%BA%91&hero_id=107&zone=aqq&type=all"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
完全免费
QPS 限制
QPS 3
登录免费额度
200 次（已认证）
匿名每日额度
50 次（无 API Key）
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-05-06

    首次上线，聚合英雄列表 + 全国战力 2 个 action 英雄列表双源容灾：腾讯官方失败自动降级 yxsaoma.com 内置 MD5 签名（warzoneSignKey20240515 + timestamp + 字典序拼接） 英雄列表缓存 24h、战力数据缓存 1h type=min/max 时按 level（省/市/区）分组，输出 extreme + similar（rank 差距 ≤ +100 相近排名） find_hero 同时支持 hero（中文名）和 hero_id（ename）两种定位方式

免责声明

王者荣耀官方数据可能存在分钟级差异。synDate 字段标记服务同步日期，每天更新一次。新英雄刚上线时可能暂无战力数据。

王者战力查询 接入文档｜极数本源