提供 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 等参数均支持常见别名,便于前端灵活传参。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 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 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "action",
"type": "string",
"required": false,
"description": "操作类型,默认 rank。可选:rank(榜单明细,默认)、titles(官方榜单目录)、tier(按 T度分组总览)、career(按职业分组总览,type 为其别名)、hero(单英雄在 11 个榜单中的名次,需 heroid)。传入非上述值时自动重置为 rank。",
"example": "rank"
},
{
"name": "rankid",
"type": "string",
"required": false,
"description": "榜单编号或名称,默认 0。编号:0 英雄热度榜(含 T度/胜率/登场率/Ban率,默认)、1 强势时段榜、6 每周团战榜、7 英雄输出榜、8 英雄清野榜、9 英雄发育榜、10 英雄承伤榜、11 英雄助攻榜、12 英雄推进榜、13 英雄MVP榜、14 英雄金牌榜;也接受中文名(热度榜/输出榜/承伤榜…)、英文 slug(heat/damage…)及常见别名(人气/伤害/推塔…)。未传 rankid 时可用 rank 或 board 作为别名,优先级 rankid > rank > board。",
"example": "0"
},
{
"name": "rank",
"type": "string",
"required": false,
"description": "rankid 的别名,仅在未传 rankid 时生效。",
"example": "0"
},
{
"name": "board",
"type": "string",
"required": false,
"description": "rankid 的别名,仅在未传 rankid、rank 时生效。",
"example": "0"
},
{
"name": "type",
"type": "string",
"required": false,
"description": "职业筛选,默认 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 时生效)。",
"example": "法师"
},
{
"name": "job",
"type": "string",
"required": false,
"description": "type 的别名,仅在未传 type 时生效。",
"example": "法师"
},
{
"name": "profession",
"type": "string",
"required": false,
"description": "type 的别名,仅在未传 type、job 时生效。",
"example": "法师"
},
{
"name": "career",
"type": "string",
"required": false,
"description": "type 的别名,仅在未传 type、job、profession 时生效。注意:作为 action 值 career 表示“按职业分组总览”,作为参数名时表示职业筛选,两者可同时出现。",
"example": "法师"
},
{
"name": "position",
"type": "string",
"required": false,
"description": "分路筛选,默认 all。可传:全部|对抗路|中路|发育路|游走|打野,或 1-5(1对抗路 2中路 3发育路 4游走/辅助 5打野),也接受别名(上路/边路/中单/下路/射手路/辅助路/野区/top/mid/adc/bot/support/jungle 等)。未传 position 时可用 road 或 lane 作为别名,优先级 position > road > lane。分路由服务端过滤,可显著减小响应体积。",
"example": "发育路"
},
{
"name": "road",
"type": "string",
"required": false,
"description": "position 的别名,仅在未传 position 时生效。",
"example": "发育路"
},
{
"name": "lane",
"type": "string",
"required": false,
"description": "position 的别名,仅在未传 position、road 时生效。",
"example": "发育路"
},
{
"name": "tier",
"type": "string",
"required": false,
"description": "T度筛选,默认 all。可传:T0|T1|T2|T3|T4|none|all。注意:T度(tRank)仅「英雄热度榜」(rankid=0) 提供,其它榜单会忽略该参数并在返回中给出 tierIgnored=true 与 tierNote 提示。未传 tier 时可用 t 作为别名。",
"example": "T0"
},
{
"name": "t",
"type": "string",
"required": false,
"description": "tier 的别名,仅在未传 tier 时生效。",
"example": "T0"
},
{
"name": "sort",
"type": "string",
"required": false,
"description": "排序字段,默认空=官方榜单原序。可用 heroId|name|rank|tier 或本榜单任一列键(如 winRate/showRate/banRate/output/suffer/mvp 等,具体可用字段见响应 columns)。传入不可用字段会返回 code=-1 并列出可用字段。未传 sort 时可用 orderby 作为别名。",
"example": "winRate"
},
{
"name": "orderby",
"type": "string",
"required": false,
"description": "sort 的别名,仅在未传 sort 时生效。",
"example": "winRate"
},
{
"name": "order",
"type": "string",
"required": false,
"description": "排序方向,默认 desc。可传 desc|asc,非 asc 值一律按 desc 处理。",
"example": "desc"
},
{
"name": "limit",
"type": "integer",
"required": false,
"description": "返回条数,默认 20;传 0 表示全部。负数按 20 处理。在 action=tier/career 分组模式下,表示每组最多返回英雄数。未传 limit 时可用 size 作为别名。",
"example": "20"
},
{
"name": "size",
"type": "integer",
"required": false,
"description": "limit 的别名,仅在未传 limit 时生效。",
"example": "20"
},
{
"name": "page",
"type": "integer",
"required": false,
"description": "页码,从 1 开始,默认 1;小于 1 按 1 处理。仅 action=rank 分页返回时生效。",
"example": "1"
},
{
"name": "keyword",
"type": "string",
"required": false,
"description": "英雄名 / 英雄ID 模糊筛选。纯数字按 heroId 精确匹配,否则按英雄名不区分大小写包含匹配。未传 keyword 时可用 kw、name、q 作为别名,优先级 keyword > kw > name > q。",
"example": "妲己"
},
{
"name": "kw",
"type": "string",
"required": false,
"description": "keyword 的别名,仅在未传 keyword 时生效。",
"example": "妲己"
},
{
"name": "name",
"type": "string",
"required": false,
"description": "keyword 的别名,仅在未传 keyword、kw 时生效。",
"example": "妲己"
},
{
"name": "q",
"type": "string",
"required": false,
"description": "keyword 的别名,仅在未传 keyword、kw、name 时生效。",
"example": "妲己"
},
{
"name": "peak",
"type": "integer",
"required": false,
"description": "是否查看「巅峰赛」榜单。传 1 为巅峰赛榜,默认 0 为全段位榜。未传 peak 时可用 ifPeak 作为别名。",
"example": "0"
},
{
"name": "ifPeak",
"type": "integer",
"required": false,
"description": "peak 的别名,仅在未传 peak 时生效。",
"example": "0"
},
{
"name": "heroid",
"type": "string",
"required": false,
"description": "英雄ID,action=hero 时必填。传营地 heroId(如 109=妲己 / 142=安琪拉)。未传 heroid 时可用 hero 作为别名。",
"example": "109"
},
{
"name": "hero",
"type": "string",
"required": false,
"description": "heroid 的别名,仅在未传 heroid 时生效。",
"example": "109"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "王者荣耀英雄榜单",
"description": "提供 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 等参数均支持常见别名,便于前端灵活传参。",
"version": "1.0.0"
},
"paths": {
"/v1/wzyd_rank": {
"get": {
"summary": "王者荣耀英雄榜单",
"description": "提供 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 等参数均支持常见别名,便于前端灵活传参。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "action",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "rank"
},
"description": "操作类型,默认 rank。可选:rank(榜单明细,默认)、titles(官方榜单目录)、tier(按 T度分组总览)、career(按职业分组总览,type 为其别名)、hero(单英雄在 11 个榜单中的名次,需 heroid)。传入非上述值时自动重置为 rank。"
},
{
"name": "rankid",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "榜单编号或名称,默认 0。编号:0 英雄热度榜(含 T度/胜率/登场率/Ban率,默认)、1 强势时段榜、6 每周团战榜、7 英雄输出榜、8 英雄清野榜、9 英雄发育榜、10 英雄承伤榜、11 英雄助攻榜、12 英雄推进榜、13 英雄MVP榜、14 英雄金牌榜;也接受中文名(热度榜/输出榜/承伤榜…)、英文 slug(heat/damage…)及常见别名(人气/伤害/推塔…)。未传 rankid 时可用 rank 或 board 作为别名,优先级 rankid > rank > board。"
},
{
"name": "rank",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "rankid 的别名,仅在未传 rankid 时生效。"
},
{
"name": "board",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "rankid 的别名,仅在未传 rankid、rank 时生效。"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "职业筛选,默认 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 时生效)。"
},
{
"name": "job",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "type 的别名,仅在未传 type 时生效。"
},
{
"name": "profession",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "type 的别名,仅在未传 type、job 时生效。"
},
{
"name": "career",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "type 的别名,仅在未传 type、job、profession 时生效。注意:作为 action 值 career 表示“按职业分组总览”,作为参数名时表示职业筛选,两者可同时出现。"
},
{
"name": "position",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "发育路"
},
"description": "分路筛选,默认 all。可传:全部|对抗路|中路|发育路|游走|打野,或 1-5(1对抗路 2中路 3发育路 4游走/辅助 5打野),也接受别名(上路/边路/中单/下路/射手路/辅助路/野区/top/mid/adc/bot/support/jungle 等)。未传 position 时可用 road 或 lane 作为别名,优先级 position > road > lane。分路由服务端过滤,可显著减小响应体积。"
},
{
"name": "road",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "发育路"
},
"description": "position 的别名,仅在未传 position 时生效。"
},
{
"name": "lane",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "发育路"
},
"description": "position 的别名,仅在未传 position、road 时生效。"
},
{
"name": "tier",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "T0"
},
"description": "T度筛选,默认 all。可传:T0|T1|T2|T3|T4|none|all。注意:T度(tRank)仅「英雄热度榜」(rankid=0) 提供,其它榜单会忽略该参数并在返回中给出 tierIgnored=true 与 tierNote 提示。未传 tier 时可用 t 作为别名。"
},
{
"name": "t",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "T0"
},
"description": "tier 的别名,仅在未传 tier 时生效。"
},
{
"name": "sort",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "winRate"
},
"description": "排序字段,默认空=官方榜单原序。可用 heroId|name|rank|tier 或本榜单任一列键(如 winRate/showRate/banRate/output/suffer/mvp 等,具体可用字段见响应 columns)。传入不可用字段会返回 code=-1 并列出可用字段。未传 sort 时可用 orderby 作为别名。"
},
{
"name": "orderby",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "winRate"
},
"description": "sort 的别名,仅在未传 sort 时生效。"
},
{
"name": "order",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "desc"
},
"description": "排序方向,默认 desc。可传 desc|asc,非 asc 值一律按 desc 处理。"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 20
},
"description": "返回条数,默认 20;传 0 表示全部。负数按 20 处理。在 action=tier/career 分组模式下,表示每组最多返回英雄数。未传 limit 时可用 size 作为别名。"
},
{
"name": "size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 20
},
"description": "limit 的别名,仅在未传 limit 时生效。"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 1
},
"description": "页码,从 1 开始,默认 1;小于 1 按 1 处理。仅 action=rank 分页返回时生效。"
},
{
"name": "keyword",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "英雄名 / 英雄ID 模糊筛选。纯数字按 heroId 精确匹配,否则按英雄名不区分大小写包含匹配。未传 keyword 时可用 kw、name、q 作为别名,优先级 keyword > kw > name > q。"
},
{
"name": "kw",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "keyword 的别名,仅在未传 keyword 时生效。"
},
{
"name": "name",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "keyword 的别名,仅在未传 keyword、kw 时生效。"
},
{
"name": "q",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "keyword 的别名,仅在未传 keyword、kw、name 时生效。"
},
{
"name": "peak",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 0
},
"description": "是否查看「巅峰赛」榜单。传 1 为巅峰赛榜,默认 0 为全段位榜。未传 peak 时可用 ifPeak 作为别名。"
},
{
"name": "ifPeak",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 0
},
"description": "peak 的别名,仅在未传 peak 时生效。"
},
{
"name": "heroid",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "109"
},
"description": "英雄ID,action=hero 时必填。传营地 heroId(如 109=妲己 / 142=安琪拉)。未传 heroid 时可用 hero 作为别名。"
},
{
"name": "hero",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "109"
},
"description": "heroid 的别名,仅在未传 heroid 时生效。"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "王者荣耀英雄榜单",
"description": "提供 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 等参数均支持常见别名,便于前端灵活传参。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "action",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "rank"
},
"description": "操作类型,默认 rank。可选:rank(榜单明细,默认)、titles(官方榜单目录)、tier(按 T度分组总览)、career(按职业分组总览,type 为其别名)、hero(单英雄在 11 个榜单中的名次,需 heroid)。传入非上述值时自动重置为 rank。"
},
{
"name": "rankid",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "榜单编号或名称,默认 0。编号:0 英雄热度榜(含 T度/胜率/登场率/Ban率,默认)、1 强势时段榜、6 每周团战榜、7 英雄输出榜、8 英雄清野榜、9 英雄发育榜、10 英雄承伤榜、11 英雄助攻榜、12 英雄推进榜、13 英雄MVP榜、14 英雄金牌榜;也接受中文名(热度榜/输出榜/承伤榜…)、英文 slug(heat/damage…)及常见别名(人气/伤害/推塔…)。未传 rankid 时可用 rank 或 board 作为别名,优先级 rankid > rank > board。"
},
{
"name": "rank",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "rankid 的别名,仅在未传 rankid 时生效。"
},
{
"name": "board",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "rankid 的别名,仅在未传 rankid、rank 时生效。"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "职业筛选,默认 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 时生效)。"
},
{
"name": "job",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "type 的别名,仅在未传 type 时生效。"
},
{
"name": "profession",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "type 的别名,仅在未传 type、job 时生效。"
},
{
"name": "career",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "法师"
},
"description": "type 的别名,仅在未传 type、job、profession 时生效。注意:作为 action 值 career 表示“按职业分组总览”,作为参数名时表示职业筛选,两者可同时出现。"
},
{
"name": "position",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "发育路"
},
"description": "分路筛选,默认 all。可传:全部|对抗路|中路|发育路|游走|打野,或 1-5(1对抗路 2中路 3发育路 4游走/辅助 5打野),也接受别名(上路/边路/中单/下路/射手路/辅助路/野区/top/mid/adc/bot/support/jungle 等)。未传 position 时可用 road 或 lane 作为别名,优先级 position > road > lane。分路由服务端过滤,可显著减小响应体积。"
},
{
"name": "road",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "发育路"
},
"description": "position 的别名,仅在未传 position 时生效。"
},
{
"name": "lane",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "发育路"
},
"description": "position 的别名,仅在未传 position、road 时生效。"
},
{
"name": "tier",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "T0"
},
"description": "T度筛选,默认 all。可传:T0|T1|T2|T3|T4|none|all。注意:T度(tRank)仅「英雄热度榜」(rankid=0) 提供,其它榜单会忽略该参数并在返回中给出 tierIgnored=true 与 tierNote 提示。未传 tier 时可用 t 作为别名。"
},
{
"name": "t",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "T0"
},
"description": "tier 的别名,仅在未传 tier 时生效。"
},
{
"name": "sort",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "winRate"
},
"description": "排序字段,默认空=官方榜单原序。可用 heroId|name|rank|tier 或本榜单任一列键(如 winRate/showRate/banRate/output/suffer/mvp 等,具体可用字段见响应 columns)。传入不可用字段会返回 code=-1 并列出可用字段。未传 sort 时可用 orderby 作为别名。"
},
{
"name": "orderby",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "winRate"
},
"description": "sort 的别名,仅在未传 sort 时生效。"
},
{
"name": "order",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "desc"
},
"description": "排序方向,默认 desc。可传 desc|asc,非 asc 值一律按 desc 处理。"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 20
},
"description": "返回条数,默认 20;传 0 表示全部。负数按 20 处理。在 action=tier/career 分组模式下,表示每组最多返回英雄数。未传 limit 时可用 size 作为别名。"
},
{
"name": "size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 20
},
"description": "limit 的别名,仅在未传 limit 时生效。"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 1
},
"description": "页码,从 1 开始,默认 1;小于 1 按 1 处理。仅 action=rank 分页返回时生效。"
},
{
"name": "keyword",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "英雄名 / 英雄ID 模糊筛选。纯数字按 heroId 精确匹配,否则按英雄名不区分大小写包含匹配。未传 keyword 时可用 kw、name、q 作为别名,优先级 keyword > kw > name > q。"
},
{
"name": "kw",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "keyword 的别名,仅在未传 keyword 时生效。"
},
{
"name": "name",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "keyword 的别名,仅在未传 keyword、kw 时生效。"
},
{
"name": "q",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "妲己"
},
"description": "keyword 的别名,仅在未传 keyword、kw、name 时生效。"
},
{
"name": "peak",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 0
},
"description": "是否查看「巅峰赛」榜单。传 1 为巅峰赛榜,默认 0 为全段位榜。未传 peak 时可用 ifPeak 作为别名。"
},
{
"name": "ifPeak",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"example": 0
},
"description": "peak 的别名,仅在未传 peak 时生效。"
},
{
"name": "heroid",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "109"
},
"description": "英雄ID,action=hero 时必填。传营地 heroId(如 109=妲己 / 142=安琪拉)。未传 heroid 时可用 hero 作为别名。"
},
{
"name": "hero",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "109"
},
"description": "heroid 的别名,仅在未传 heroid 时生效。"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://api.suol.cc",
"description": "当前访问入口(https)"
}
]
}
{
"code": 0,
"msg": "ok",
"action": "rank",
"rank": {
"id": 0,
"name": "英雄热度榜",
"slug": "heat",
"peak": false
},
"updateTime": "20261121",
"columns": [
{
"name": "英雄",
"key": "heroInfo",
"type": "hero"
},
{
"name": "热度",
"key": "tRank",
"type": "tier"
},
{
"name": "胜率",
"key": "winRate",
"type": "percent"
},
{
"name": "登场率",
"key": "showRate",
"type": "percent"
},
{
"name": "Ban率",
"key": "banRate",
"type": "percent"
}
],
"query": {
"rankid": 0,
"type": "全职业",
"position": "全分路",
"tier": "all",
"sort": "",
"order": "desc",
"page": 1,
"limit": 20,
"keyword": "",
"peak": 0
},
"updated": 1795347009,
"total": 134,
"count": 20,
"skipped": 2,
"filters": {
"careers": [
{
"id": 0,
"name": "全职业"
},
{
"id": 1,
"name": "坦克"
},
{
"id": 2,
"name": "战士"
},
{
"id": 3,
"name": "刺客"
},
{
"id": 4,
"name": "法师"
},
{
"id": 5,
"name": "射手"
},
{
"id": 6,
"name": "辅助"
}
],
"positions": [
{
"id": 0,
"name": "全分路"
},
{
"id": 1,
"name": "对抗路"
},
{
"id": 2,
"name": "中路"
},
{
"id": 3,
"name": "发育路"
},
{
"id": 4,
"name": "游走"
},
{
"id": 5,
"name": "打野"
}
],
"tiers": [
"T0",
"T1",
"T2",
"T3",
"T4"
],
"official": {
"分路": {
"1": "对抗路",
"2": "中路",
"3": "发育路",
"4": "游走",
"5": "打野"
}
}
},
"summary": {
"topHero": "妲己",
"avgWinRate": 0.4957,
"avgShowRate": 0.0746,
"avgBanRate": 0.0663
},
"tierSummary": {
"T0": 10,
"T1": 15,
"T2": 41,
"T3": 29,
"T4": 39
},
"tierNote": "T度是营地官方热度分档(T0 = 登场率最高),不是强度分级;看强度请 sort=winRate 或 sort=banRate",
"list": [
{
"rank": 1,
"heroId": "109",
"name": "妲己",
"career": [
"法师"
],
"careerText": "法师",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.5059,
"showRate": 0.324,
"banRate": 0.1831
},
"text": {
"tRank": "T0",
"winRate": "50.59%",
"showRate": "32.4%",
"banRate": "18.31%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/ca7c2d402047b11cc3ff1681e9a0028e.png"
},
{
"rank": 2,
"heroId": "142",
"name": "安琪拉",
"career": [
"法师"
],
"careerText": "法师",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.4918,
"showRate": 0.351,
"banRate": 0.103
},
"text": {
"tRank": "T0",
"winRate": "49.18%",
"showRate": "35.1%",
"banRate": "10.3%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/b64a85d622df2c8fd7ecb557885ca2c2.png"
},
{
"rank": 3,
"heroId": "505",
"name": "瑶",
"career": [
"辅助",
"法师"
],
"careerText": "辅助/法师",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.5083,
"showRate": 0.251,
"banRate": 0.3536
},
"text": {
"tRank": "T0",
"winRate": "50.83%",
"showRate": "25.1%",
"banRate": "35.36%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/6a2b0b9639d6df7e371101d5dde87a78.png"
},
{
"rank": 4,
"heroId": "108",
"name": "墨子",
"career": [
"法师",
"战士"
],
"careerText": "法师/战士",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.5233,
"showRate": 0.115,
"banRate": 0.6451
},
"text": {
"tRank": "T0",
"winRate": "52.33%",
"showRate": "11.5%",
"banRate": "64.51%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/deb788f3a436229b41fcbf80a867c6dc.png"
},
{
"rank": 5,
"heroId": "507",
"name": "李信",
"career": [
"战士"
],
"careerText": "战士",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.5393,
"showRate": 0.228,
"banRate": 0.265
},
"text": {
"tRank": "T0",
"winRate": "53.93%",
"showRate": "22.8%",
"banRate": "26.5%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/526247a6f22df879a418cb743f43f8e4.png"
},
{
"rank": 6,
"heroId": "106",
"name": "小乔",
"career": [
"法师"
],
"careerText": "法师",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.4788,
"showRate": 0.285,
"banRate": 0.0159
},
"text": {
"tRank": "T0",
"winRate": "47.88%",
"showRate": "28.5%",
"banRate": "1.59%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/34ca070ab867be1157b81b688be18cbb.png"
},
{
"rank": 7,
"heroId": "646",
"name": "刀锋宝贝",
"career": [
"战士",
"刺客"
],
"careerText": "战士/刺客",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.504,
"showRate": 0.229,
"banRate": 0.1704
},
"text": {
"tRank": "T0",
"winRate": "50.4%",
"showRate": "22.9%",
"banRate": "17.04%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/compress/custom_wzry_skin_128x128/e6f9bf839a34abb4b0c2aa4e8e68471c.jpg"
},
{
"rank": 8,
"heroId": "169",
"name": "后羿",
"career": [
"射手"
],
"careerText": "射手",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.5183,
"showRate": 0.265,
"banRate": 0.0196
},
"text": {
"tRank": "T0",
"winRate": "51.83%",
"showRate": "26.5%",
"banRate": "1.96%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/7e1fc4519ceeff9db430f9062d3df4ac.png"
},
{
"rank": 9,
"heroId": "159",
"name": "朵莉亚",
"career": [
"辅助",
"法师"
],
"careerText": "辅助/法师",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.4704,
"showRate": 0.194,
"banRate": 0.1689
},
"text": {
"tRank": "T0",
"winRate": "47.04%",
"showRate": "19.4%",
"banRate": "16.89%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/d2805fb51a836d953e9a6d5e8c695d32.png"
},
{
"rank": 10,
"heroId": "152",
"name": "王昭君",
"career": [
"法师"
],
"careerText": "法师",
"tier": "T0",
"values": {
"tRank": "T0",
"winRate": 0.5058,
"showRate": 0.192,
"banRate": 0.1449
},
"text": {
"tRank": "T0",
"winRate": "50.58%",
"showRate": "19.2%",
"banRate": "14.49%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/dcd22aca5aa73428701166983f7a4eb0.png"
},
{
"rank": 11,
"heroId": "112",
"name": "鲁班七号",
"career": [
"射手"
],
"careerText": "射手",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.4921,
"showRate": 0.19,
"banRate": 0.0151
},
"text": {
"tRank": "T1",
"winRate": "49.21%",
"showRate": "19%",
"banRate": "1.51%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/0cf5b1269357589da5a2669f2ec50ee5.png"
},
{
"rank": 12,
"heroId": "184",
"name": "蔡文姬",
"career": [
"辅助",
"法师"
],
"careerText": "辅助/法师",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.5185,
"showRate": 0.135,
"banRate": 0.275
},
"text": {
"tRank": "T1",
"winRate": "51.85%",
"showRate": "13.5%",
"banRate": "27.5%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/fa489684bd4078fe373d94510dfd5146.png"
},
{
"rank": 13,
"heroId": "123",
"name": "吕布",
"career": [
"战士",
"坦克"
],
"careerText": "战士/坦克",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.4833,
"showRate": 0.171,
"banRate": 0.0771
},
"text": {
"tRank": "T1",
"winRate": "48.33%",
"showRate": "17.1%",
"banRate": "7.71%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/dafe931fe9bec2cd47748dc2bfca7b01.png"
},
{
"rank": 14,
"heroId": "155",
"name": "艾琳",
"career": [
"射手"
],
"careerText": "射手",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.4974,
"showRate": 0.175,
"banRate": 0.0441
},
"text": {
"tRank": "T1",
"winRate": "49.74%",
"showRate": "17.5%",
"banRate": "4.41%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/c60893e14d47772231045f2523c631b3.png"
},
{
"rank": 15,
"heroId": "132",
"name": "马可波罗",
"career": [
"射手"
],
"careerText": "射手",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.49,
"showRate": 0.173,
"banRate": 0.0525
},
"text": {
"tRank": "T1",
"winRate": "49%",
"showRate": "17.3%",
"banRate": "5.25%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/67bce625e42b9332aa96bf08519607c1.png"
},
{
"rank": 16,
"heroId": "549",
"name": "心魔六耳",
"career": [
"刺客",
"战士"
],
"careerText": "刺客/战士",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.5153,
"showRate": 0.153,
"banRate": 0.1349
},
"text": {
"tRank": "T1",
"winRate": "51.53%",
"showRate": "15.3%",
"banRate": "13.49%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/compress/custom_wzry_skin_128x128/254d431c2b788cbd3f8b3d09f38e9603.jpg"
},
{
"rank": 17,
"heroId": "135",
"name": "项羽",
"career": [
"坦克",
"战士"
],
"careerText": "坦克/战士",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.5102,
"showRate": 0.16,
"banRate": 0.047
},
"text": {
"tRank": "T1",
"winRate": "51.02%",
"showRate": "16%",
"banRate": "4.7%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/823872b5a950e1ba77c80ea378436848.png"
},
{
"rank": 18,
"heroId": "167",
"name": "孙悟空",
"career": [
"刺客"
],
"careerText": "刺客",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.4837,
"showRate": 0.158,
"banRate": 0.0486
},
"text": {
"tRank": "T1",
"winRate": "48.37%",
"showRate": "15.8%",
"banRate": "4.86%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/1766c0d296abbcaaa51b83d5606a9209.png"
},
{
"rank": 19,
"heroId": "126",
"name": "夏侯惇",
"career": [
"坦克",
"战士"
],
"careerText": "坦克/战士",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.5462,
"showRate": 0.151,
"banRate": 0.0703
},
"text": {
"tRank": "T1",
"winRate": "54.62%",
"showRate": "15.1%",
"banRate": "7.03%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/30fae784f10b6b83ab5ec959620b0527.png"
},
{
"rank": 20,
"heroId": "174",
"name": "虞姬",
"career": [
"射手"
],
"careerText": "射手",
"tier": "T1",
"values": {
"tRank": "T1",
"winRate": 0.503,
"showRate": 0.139,
"banRate": 0.133
},
"text": {
"tRank": "T1",
"winRate": "50.3%",
"showRate": "13.9%",
"banRate": "13.3%"
},
"icon": "https://game-1255653016.file.myqcloud.com/manage/custom_wzry_skin_128x128/8edbd888e498ead9120d7fc48196bd57.png"
}
]
}
暂无详细文档
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
// 结果将在此处显示
生效日期:2026年7月22日
欢迎使用 xiaoapi.cn(以下简称"本平台")。在使用本平台提供的 API 服务(以下简称"本服务")前,请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务,即视为您已阅读、理解并同意接受本声明的全部内容。
本平台作为 API 技术服务的提供方,仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界,督促用户合法、合规地使用本服务,防范违法违规行为的发生。
用户在使用本服务时,明确禁止从事以下行为:
在法律法规允许的最大范围内,本平台对以下情形不承担责任:
因用户违反本声明或相关法律法规,导致本平台及其关联方、合作方遭受任何损失(包括但不限于赔偿款、罚款、律师费、诉讼费等),用户同意向本平台及相关方承担全部赔偿责任。
本平台有权根据法律法规变化、业务调整或监管要求,随时修改本声明。修改后的声明将在本页面公布,自公布之日起生效。您继续使用本服务,即视为接受更新后的声明。
如您对本声明有任何疑问,或发现他人存在违规使用本服务的行为,欢迎通过本平台公示的联系方式与我们联系,我们将及时处理。