王者荣耀战绩查询

概述

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

鉴权

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

获取 API Key：获取 API Key/account/keys

搜索玩家

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": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "search",
  "keyword": "韩信"
}

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

角色列表

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": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "roles",
  "user_id": "123456"
}

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

历史战绩

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": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "battles",
  "user_id": "123456",
  "role_id": "1",
  "last_time": "0",
  "option": "0",
  "pages": "1"
}

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

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/wzry-battle" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "session": "{\"ssoopenid\":\"...\",\"ssotoken\":\"...\"}",
  "action": "search",
  "keyword": "韩信",
  "user_id": "123456",
  "role_id": "1",
  "last_time": "0",
  "option": "0",
  "pages": "1"
}'

错误码

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

调用限制

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

更新日志

• 1.2.02026-08-12

  登录态改为调用方每次临时上传（session / multipart / ssoopenid+ssotoken）；废弃服务端共用 session.json

• 1.1.02026-08-01

  补齐 search/roles/battles 子接口文档与错误码

• 1.0.02026-05-01

  首次上线

免责声明