王者荣耀战绩查询

wzry-battlePOST

通过王者营地小程序接口查询玩家战报，支持搜索玩家、查询角色列表、获取历史战绩与 KDA 统计。

POSThttps://v1.apizero.cn/api/wzry-battle

aidocs.page.getKey 工作台购买 / 调试

平台约定

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

/aidocs/wzry-battle/raw.md

打开 Markdown

鉴权

每次请求须临时上传王者营地登录态（session / multipart / ssoopenid+ssotoken），服务端不落盘、不全站共用。支持匿名试用（受每日免费额度与 QPS 限制）；携带 API Key 可提升额度。鉴权字段与兼容写法见下方「请求头说明」。

获取 API Key：/account/keys

请求头

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

搜索玩家

POSTAPPLICATION/JSON·APPLICATION/JSON

https://v1.apizero.cn/api/wzry-battle?session=%7B%22ssoopenid%22%3A%22...%22%2C%22ssotoken%22%3A%22...%22%7D&action=search&keyword=%E9%9F%A9%E4%BF%A1

参数	类型	必填	说明	示例
session	object	是	临时登录态（同主文档 session）	{"ssoopenid":"...","ssotoken":"..."}
action	string	是	固定 search	search
keyword	string	是	玩家昵称关键词	韩信

{
  "session": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "search",
  "keyword": "韩信"
}

响应字段

字段	类型	说明
total	integer	匹配玩家数
list	array	玩家列表
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "total": 1,
    "list": [
      {
        "userId": "123",
        "nickname": "韩信"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

角色列表

POSTAPPLICATION/JSON·APPLICATION/JSON

https://v1.apizero.cn/api/wzry-battle?session=%7B%22ssoopenid%22%3A%22...%22%2C%22ssotoken%22%3A%22...%22%7D&action=roles&user_id=123456

参数	类型	必填	说明	示例
session	object	是	临时登录态（同主文档 session）	{"ssoopenid":"...","ssotoken":"..."}
action	string	是	固定 roles	roles
user_id	string	是	玩家 userId	123456

{
  "session": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "roles",
  "user_id": "123456"
}

响应字段

字段	类型	说明
list	array	角色列表
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "list": [
      {
        "roleId": "1",
        "roleName": "韩信"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

历史战绩

POSTAPPLICATION/JSON·APPLICATION/JSON

https://v1.apizero.cn/api/wzry-battle?session=%7B%22ssoopenid%22%3A%22...%22%2C%22ssotoken%22%3A%22...%22%7D&action=battles&user_id=123456&role_id=1&last_time=0&option=0&pages=1

参数	类型	必填	说明	示例
session	object	是	临时登录态（同主文档 session）	{"ssoopenid":"...","ssotoken":"..."}
action	string	是	固定 battles	battles
user_id	string	是	玩家 userId	123456
role_id	string	是	角色 roleId	1
last_time	integer	否	翻页游标（Unix 秒），0=最新	0
option	integer	否	0全部 1排位 2巅峰 3娱乐	0
pages	integer	否	每次拉取页数（1-3）	1

{
  "session": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "battles",
  "user_id": "123456",
  "role_id": "1",
  "last_time": "0",
  "option": "0",
  "pages": "1"
}

响应字段

字段	类型	说明
list	array	战报列表
last_time	integer	下一页游标
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "list": [],
    "last_time": 0
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

将 YOUR_API_KEY 替换为真实 Key 后运行。

# 1. 密钥：登录 https://apizero.cn/account/keys 申请，写入环境变量 APIZERO_KEY
#    请求头 Authorization: Bearer <key>
import json
import os
import urllib.request

key = os.environ["APIZERO_KEY"]

# 2. 请求地址
url = "https://v1.apizero.cn/api/wzry-battle"

# 3. 发请求
payload = {
    "session": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
    "action": "search",
    "keyword": "韩信",
    "user_id": "123456",
    "role_id": "1",
    "last_time": "0",
    "option": "0",
    "pages": "1",
}
req = urllib.request.Request(
    url,
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + key,
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(req, timeout=15) as resp:
    body = json.loads(resp.read().decode("utf-8"))

# 4. 打印整包。
#   第 5 步的字段按本接口 data 里实际键改。
print(json.dumps(body, ensure_ascii=False, indent=2))

# 5. code == 0 后再取字段
if body.get("code") == 0:
    data = body.get("data") or {}
    print(data)

在线调试

填写参数后运行，将真实调用接口；计入免费额度。

RequestPOST

POST https://v1.apizero.cn/api/wzry-battle

认证方式

参数(8)

sessionobject必填

【必填·临时登录态】王者营地登录态 JSON（结构见 session.example.json）。也可 multipart 上传 session/session_file，或传 ssoopenid+ssotoken。仅本次请求使用，服务端不落盘、不全站共用。

actionstring必填

search / roles / battles

keywordstring

[search] 玩家昵称关键词

user_idstring

[roles/battles] 玩家 userId

role_idstring

[battles] 角色 roleId

last_timeinteger

[battles] 翻页游标

optioninteger

[battles] 模式筛选

pagesinteger

[battles] 拉取页数 1-3

待运行

填写参数后点击「运行调试」查看响应

错误码

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

业务码	HTTP	说明
0	200	成功
4000	400	参数错误
4011	401	API Key 无效
4013	403	API Key 已暂停
4014	403	当前 IP 不在 Key 白名单
4015	401	此接口需要 API Key
4022	402	余额不足
4029	429	调用过快（QPS）
4030	429	今日免费额度已用完
4040	503	接口已下线
4041	404	接口不存在
5000	500	服务器内部错误
5020	502	上游暂时不可用
5021	502	上游返回格式异常
5030	502	暂无可用节点

额度与计费

计费模式	完全免费
QPS 限制	2 req/s
登录免费额度	20 次（已认证）
匿名每日额度	5 次（无 API Key）
黄金会员	每日 50000 次 · QPS 10
企业会员	每日 1000000 次 · QPS 120

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

变更日志

1.2.02026-08-12
登录态改为调用方每次临时上传（session / multipart / ssoopenid+ssotoken）；废弃服务端共用 session.json
1.1.02026-08-01
补齐 search/roles/battles 子接口文档与错误码
1.0.02026-05-01
首次上线

免责声明

每次请求须由调用方临时上传王者营地登录态（JSON 字段 session / multipart 上传 session 或 session_file / 扁平字段 ssoopenid+ssotoken）。服务端仅本次请求使用，不落盘、不全站共用。登录态过期后请自行重新抓包并上传。