王者战力查询 API 接入文档wzry

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

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

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

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/wzry",
    params={
    "action": "query",
    "hero": "赵云",
    "hero_id": "",
    "zone": "aqq",
    "type": "all",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "action": "query",
  "hero": "赵云",
  "hero_id": "",
  "zone": "aqq",
  "type": "all",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/wzry?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/wzry", nil)
	q := req.URL.Query()
	q.Set("action", "query")
	q.Set("hero", "赵云")
	q.Set("hero_id", "")
	q.Set("zone", "aqq")
	q.Set("type", "all")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/wzry?" . http_build_query([
    "action" => "query",
    "hero" => "赵云",
    "hero_id" => "",
    "zone" => "aqq",
    "type" => "all",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

{
    "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": "min",
        "syn_date": "2026-05-06",
        "rank_data": {
            "extreme": {
                "province": {
                    "address": "云南",
                    "level": "province",
                    "rank": 4500,
                    "adcode": "..."
                },
                "city": {
                    "address": "海南\/三亚市",
                    "level": "city",
                    "rank": 1800,
                    "adcode": "..."
                },
                "district": {
                    "address": "北京\/朝阳区",
                    "level": "district",
                    "rank": 800,
                    "adcode": "..."
                }
            },
            "similar": {
                "province": [
                    {
                        "address": "云南",
                        "rank": 4500
                    },
                    {
                        "address": "甘肃",
                        "rank": 4520
                    }
                ],
                "city": [],
                "district": []
            }
        }
    },
    "request_id": "abc123def456"
}

• 1.0.0(2026-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）两种定位方式