/ 接口详情
/ 接口详情 · 网络工具
GET / POST

王者荣耀英雄榜单

提供 11 个官方榜单的明细数据与多维度筛选:英雄热度榜(含 T度/胜率/登场率/Ban率)、强势时段榜、每周团战榜、英雄输出榜、英雄清野榜、英雄发育榜、英雄承伤榜、英雄助攻榜、英雄推进榜、英雄MVP榜、英雄金牌榜。数据字段、名次与更新时间与营地 H5「英雄榜单」页完全一致,响应中的 columns 会按榜单动态生成表头,前端可直接按 columns 渲染;百分比字段原值放 values(0-1 小数)、展示值放 text(如 "50.6%")。接口支持按职业(坦克/战士/刺客/法师/射手/辅助)、分路(对抗路/中路/发育路/游走/打野)、T度(T0-T4,仅热度榜)、关键词(英雄名/英雄ID)筛选,支持按任意列键排序与分页,并提供 titles(榜单目录)、tier(按 T度分组)、career(按职业分组)、hero(单英雄在 11 个榜单中的名次)等便捷动作。请求方式支持 GET、POST 表单以及 POST JSON 体;rankid、type、position、tier、keyword、peak 等参数均支持常见别名,便于前端灵活传参。

调用 14 次 1 积分 / 次 KEY 必填 QPM 30/MIN Query 参数
返回接口市场
接口信息
GET / POST api.suol.cc/v1/wzyd_rank
方法
GET / POST
分类
网络工具
计费
1 积分 / 次
KEY
KEY 必填
调用
14
QPM
30/MIN
鉴权
Query 参数
作者

请求参数

参数名类型必填说明示例
key string 是 接口调用密钥
action string 否 操作类型,默认 rank。可选:rank(榜单明细,默认)、titles(官方榜单目录)、tier(按 T度分组总览)、career(按职业分组总览,type 为其别名)、hero(单英雄在 11 个榜单中的名次,需 heroid)。传入非上述值时自动重置为 rank。 rank
rankid string 否 榜单编号或名称,默认 0。编号:0 英雄热度榜(含 T度/胜率/登场率/Ban率,默认)、1 强势时段榜、6 每周团战榜、7 英雄输出榜、8 英雄清野榜、9 英雄发育榜、10 英雄承伤榜、11 英雄助攻榜、12 英雄推进榜、13 英雄MVP榜、14 英雄金牌榜;也接受中文名(热度榜/输出榜/承伤榜…)、英文 slug(heat/damage…)及常见别名(人气/伤害/推塔…)。未传 rankid 时可用 rank 或 board 作为别名,优先级 rankid > rank > board。 0
rank string 否 rankid 的别名,仅在未传 rankid 时生效。 0
board string 否 rankid 的别名,仅在未传 rankid、rank 时生效。 0
type string 否 职业筛选,默认 all。可传:全部|坦克|战士|刺客|法师|射手|辅助,或 1-6(1坦克 2战士 3刺客 4法师 5射手 6辅助,与官方 filter 顺序一致),也接受英文(tank/warrior/assassin/mage/marksman/support 等)。按“包含”匹配,选射手可命中“射手/刺客”。未传 type 时可用 job、profession、career 作为别名(注意 career 同时是 action 值,作为参数名时仅在未传 type/job/profession 时生效)。 法师
job string 否 type 的别名,仅在未传 type 时生效。 法师
profession string 否 type 的别名,仅在未传 type、job 时生效。 法师
career string 否 type 的别名,仅在未传 type、job、profession 时生效。注意:作为 action 值 career 表示“按职业分组总览”,作为参数名时表示职业筛选,两者可同时出现。 法师
position string 否 分路筛选,默认 all。可传:全部|对抗路|中路|发育路|游走|打野,或 1-5(1对抗路 2中路 3发育路 4游走/辅助 5打野),也接受别名(上路/边路/中单/下路/射手路/辅助路/野区/top/mid/adc/bot/support/jungle 等)。未传 position 时可用 road 或 lane 作为别名,优先级 position > road > lane。分路由服务端过滤,可显著减小响应体积。 发育路
road string 否 position 的别名,仅在未传 position 时生效。 发育路
lane string 否 position 的别名,仅在未传 position、road 时生效。 发育路
tier string 否 T度筛选,默认 all。可传:T0|T1|T2|T3|T4|none|all。注意:T度(tRank)仅「英雄热度榜」(rankid=0) 提供,其它榜单会忽略该参数并在返回中给出 tierIgnored=true 与 tierNote 提示。未传 tier 时可用 t 作为别名。 T0
t string 否 tier 的别名,仅在未传 tier 时生效。 T0
sort string 否 排序字段,默认空=官方榜单原序。可用 heroId|name|rank|tier 或本榜单任一列键(如 winRate/showRate/banRate/output/suffer/mvp 等,具体可用字段见响应 columns)。传入不可用字段会返回 code=-1 并列出可用字段。未传 sort 时可用 orderby 作为别名。 winRate
orderby string 否 sort 的别名,仅在未传 sort 时生效。 winRate
order string 否 排序方向,默认 desc。可传 desc|asc,非 asc 值一律按 desc 处理。 desc
limit integer 否 返回条数,默认 20;传 0 表示全部。负数按 20 处理。在 action=tier/career 分组模式下,表示每组最多返回英雄数。未传 limit 时可用 size 作为别名。 20
size integer 否 limit 的别名,仅在未传 limit 时生效。 20
page integer 否 页码,从 1 开始,默认 1;小于 1 按 1 处理。仅 action=rank 分页返回时生效。 1
keyword string 否 英雄名 / 英雄ID 模糊筛选。纯数字按 heroId 精确匹配,否则按英雄名不区分大小写包含匹配。未传 keyword 时可用 kw、name、q 作为别名,优先级 keyword > kw > name > q。 妲己
kw string 否 keyword 的别名,仅在未传 keyword 时生效。 妲己
name string 否 keyword 的别名,仅在未传 keyword、kw 时生效。 妲己
q string 否 keyword 的别名,仅在未传 keyword、kw、name 时生效。 妲己
peak integer 否 是否查看「巅峰赛」榜单。传 1 为巅峰赛榜,默认 0 为全段位榜。未传 peak 时可用 ifPeak 作为别名。 0
ifPeak integer 否 peak 的别名,仅在未传 peak 时生效。 0
heroid string 否 英雄ID,action=hero 时必填。传营地 heroId(如 109=妲己 / 142=安琪拉)。未传 heroid 时可用 hero 作为别名。 109
hero string 否 heroid 的别名,仅在未传 heroid 时生效。 109
推荐接口