王者荣耀战绩查询wzry-battle
通过王者营地小程序接口查询玩家战报,支持搜索玩家、查询角色列表、获取历史战绩与 KDA 统计。
1. 基本信息
| 接口地址 | https://v1.apizero.cn/api/wzry-battle |
|---|---|
| 请求方法 | POST |
| 分类 | content |
| 提供方 | 极数本源 · ApiZero |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 2 req/s |
| 每日免费额度 | 20 次(已认证用户) |
| 匿名每日额度 | 5 次(无 API Key) |
| VIP 免费 | 否 |
| 调用次数 |
2. 认证
携带 X-Api-Key 请求头可获得更高调用频度和更快速率
获取 API Key:登录 https://apizero.cn/account/keys
3. 请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
action | string | 是 | 操作类型:search / roles / battles | — |
keyword | string | 否 | [search] 玩家昵称关键词 | — |
user_id | string | 否 | [roles/battles] 玩家 userId | — |
role_id | string | 否 | [battles] 角色 roleId | — |
last_time | int | 否 | [battles] 翻页游标(Unix 时间戳),0=最新 | — |
option | int | 否 | [battles] 模式筛选:0=全部 1=排位 2=巅峰 3=娱乐 | — |
pages | int | 否 | [battles] 拉取页数(1~3,每页约 30 条) | — |
5. 请求示例
以下 5 种语言示例都是可直接运行的,只需把 YOUR_API_KEY 替换为实际 Key。
cURL
curl -X POST "https://v1.apizero.cn/api/wzry-battle" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "<action>",
"keyword": "<keyword>",
"user_id": "<user_id>",
"role_id": "<role_id>",
"last_time": "<last_time>",
"option": "<option>",
"pages": "<pages>"
}'Python
import requests
resp = requests.request(
"POST",
"https://v1.apizero.cn/api/wzry-battle",
headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
json={
"action": "<action>",
"keyword": "<keyword>",
"user_id": "<user_id>",
"role_id": "<role_id>",
"last_time": "<last_time>",
"option": "<option>",
"pages": "<pages>",
},
timeout=15,
)
resp.raise_for_status()
print(resp.json())JavaScript (Node.js)
// Node.js 18+ / 浏览器原生 fetch
const res = await fetch("https://v1.apizero.cn/api/wzry-battle", {
method: "POST",
headers: {
"X-Api-Key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"action": "<action>",
"keyword": "<keyword>",
"user_id": "<user_id>",
"role_id": "<role_id>",
"last_time": "<last_time>",
"option": "<option>",
"pages": "<pages>"
}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);Go
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
body := []byte(`{"action":"<action>","keyword":"<keyword>","user_id":"<user_id>","role_id":"<role_id>","last_time":"<last_time>","option":"<option>","pages":"<pages>"}`)
req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/wzry-battle", bytes.NewBuffer(body))
req.Header.Set("X-Api-Key", "YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))
}PHP
<?php
$payload = json_encode([
"action" => "<action>",
"keyword" => "<keyword>",
"user_id" => "<user_id>",
"role_id" => "<role_id>",
"last_time" => "<last_time>",
"option" => "<option>",
"pages" => "<pages>",
], JSON_UNESCAPED_UNICODE);
$ch = curl_init("https://v1.apizero.cn/api/wzry-battle");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HTTPHEADER => [
"X-Api-Key: YOUR_API_KEY",
"Content-Type: application/json",
],
CURLOPT_TIMEOUT => 15,
]);
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
print_r($data);7. 响应示例
{
"code": 200,
"message": "success",
"data": {}
}