王者荣耀战区查询文档

文档更新日期：2026-10-01
接口版本：v1
站点地址：https://zhanqudingwei.com/

本业务只查询本站已经采集并保存的战力快照，不直接访问上游查询接口，不创建战区修改订单，不扣代理点数。所有路径均相对于站点根目录。

1. 接口与认证

查询、英雄列表和地区接口不需要登录、卡券编号、Authorization 或 X-API-Key：

方法	路径	说明
`GET`	`/api/v1/public/rank/heroes`	英雄列表、头像、称号和多分类
`GET`	`/api/v1/public/rank/hero`	查询单英雄战力
`GET`	`/api/v1/public/cards/:code/rank/heroes`	按查询卡券获取英雄列表
`GET`	`/api/v1/public/cards/:code/rank/hero`	按查询卡券查询战力
`POST`	`/api/v1/public/cards/:code/rank/query`	提交查询卡券的查询动作
`GET`	`/api/v1/public/games/1/district/tree`	王者荣耀地区树
`GET`	`/api/v1/public/games/1/district/search`	王者荣耀地区搜索

公共战力查询按 IP 每分钟最多 60 次，超过限制返回 HTTP 429，并返回 Retry-After。正常响应同时满足 HTTP 200 和 body code=0：

{
  "code": 0,
  "data": {},
  "request_id": "req_1788280200_4fae617d31ad"
}

request_id 同时位于响应头 X-Request-ID 和响应体，只用于排查，不是幂等键。参数错误使用 40001，战力快照暂不可用使用 503，不要根据中文错误文案编写状态机。

2. 英雄列表

GET https://zhanqudingwei.com/api/v1/public/rank/heroes

列表项字段：

字段	说明
`hero_code`	英雄编号
`hero_name` / `name`	英雄名称，查询时使用 `hero_name`
`title`	英雄称号
`avatar_url`	本站英雄头像地址
`categories`	全部分类对象，一个英雄可有多个分类
`category_ids` / `category_names`	分类 ID 和名称数组

固定分类为：1=战士、2=法师、3=坦克、4=刺客、5=射手、6=辅助。不要使用英雄编号、拼音 ID 或称号代替 hero_name。

3. 查询单英雄战力

GET https://zhanqudingwei.com/api/v1/public/rank/hero?hero_name=%E5%BB%89%E9%A2%87&game_area=4&rank_level=district&limit=200

参数	必填	说明
`hero_name`	是	英雄名称，例如 `廉颇`
`game_area`	是	`1=苹果微信`、`2=苹果QQ`、`3=安卓微信`、`4=安卓QQ`
`rank_level`	是	`province=省榜（金牌）`、`city=市榜（银牌）`、`district=区榜（铜牌）`
`limit`	否	`1-500`，默认 `200`

金牌、银牌、铜牌只是榜单称谓，实际请求必须传英文枚举值。战力结果使用系统采集的本地数据，没有可用快照时返回 503，不会临时直连上游。

返回示例：

{
  "code": 0,
  "data": {
    "hero_name": "廉颇",
    "game_area": 4,
    "rank_level": "district",
    "rows": [
      {
        "id": 27076100,
        "hero_name": "廉颇",
        "game_area": 4,
        "rank_level": "district",
        "region_text": "广东/惠州市/惠城区",
        "power": 1005,
        "source_updated_at_time": "2026-09-23 08:55:16",
        "location": {
          "province": "广东省",
          "city": "惠州市",
          "district": "惠城区",
          "longitude": 114.3828,
          "latitude": 23.08377,
          "location_addr": "广东省/惠州市/惠城区"
        },
        "can_modify": true
      }
    ]
  },
  "request_id": "req_1788280200_4fae617d31ad"
}

对外只保留 source_updated_at_time 一个业务更新时间字段，格式固定为北京时间 YYYY-MM-DD HH:mm:ss。它来自上游 source_updated_at，不是本系统采集时间，也不是上游 updated_at。

4. 地区树与地区搜索

GET https://zhanqudingwei.com/api/v1/public/games/1/district/tree
GET https://zhanqudingwei.com/api/v1/public/games/1/district/search?q=深圳南山&limit=20

q 和 keyword 二选一，不能同时传；limit 范围为 1-100，默认 30。地区记录包含：id、game_id、source_id、province、city、district、longitude、latitude、platform、location_addr 和 location。

王者荣耀地区接口的 game_id 固定为 1。地区 ID、source_id 和坐标不能与和平精英地区混用。旧路径 /api/v1/public/district/tree 和 /api/v1/public/district/search 仅保留给王者兼容调用。

5. 查询卡券入口

如果需要一个可交给用户的查询卡券入口，使用代理订单 API：

POST https://zhanqudingwei.com/api/v1/open/card-links
X-API-Key: API_xxxxxxxxxxx
Idempotency-Key: rank-link-20261001-0001
Content-Type: application/json

{ "product_type": "rank_query" }

返回 public_path 形如 /l?=ABC12345。该接口只生成本站入口，不访问上游、不创建修改订单、不扣点。相同 API Key、相同幂等键和相同请求重试会复用原结果。

6. curl 示例

curl --fail-with-body \
  "https://zhanqudingwei.com/api/v1/public/rank/heroes"

curl --fail-with-body --get \
  "https://zhanqudingwei.com/api/v1/public/rank/hero" \
  --data-urlencode "hero_name=廉颇" \
  --data-urlencode "game_area=4" \
  --data-urlencode "rank_level=district" \
  --data-urlencode "limit=200"