王者常用英雄 GET 正常
查询营地资料卡常用英雄(战力、胜率、场次、荣誉简称)。
-
总调用次数
可用状态
正常
100.00%
24h成功率
0ms
平均响应
0
24h调用
接口地址
请求方式 GET
返回格式 JSON
别名 wzyx
计费 免费
请求示例
在线调试 GET
响应结果
未请求 · 填写参数后点击发送(直连接口,无代理)
// 响应结果将显示在这里
参数说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 在请求中携带,如 ?apikey=你的密钥。可在登录后自动填入,或到我的账户查看。 |
| camp_id | string | 是 | 要查询的营地 ID;不传则使用登录态 userId |
| userId | string | 是 | 营地登录 userId,来自 /api/wzlogin/ 扫码成功后的 data.account.userId |
| token | string | 是 | 营地登录 token,来自 data.account.token |
| userKey | string | 否 | 营地签名密钥;有则优先。可与 encodeRes 二选一 |
| encodeRes | string | 否 | wzlogin 返回的 encodeRes;无 userKey 时用于解出密钥 |
| account | object | 否 | 可把 wzlogin 的 data.account 整包以 JSON 字符串传入,自动拆出 userId/token/userKey 等 |
| openId | string | 否 | 营地 openId / appOpenid,部分玩法接口需要 |
| gameRoleId | string | 否 | 游戏角色 ID;不传则按营地资料自动解析 |
| gameServerId | string | 否 | 游戏区服 ID |
| gameAreaId | string | 否 | 游戏大区 ID |
返回参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,1 成功 0 失败 |
| msg | string | 状态信息,失败时为原因说明 |
| data | object | 结果数据;失败时为 null |
| data.campId | string | 查询的营地 ID |
| data.roleId | string | 游戏角色 ID |
| data.heroes | array | 常用英雄列表 |
| data.heroes[].heroId | int | 英雄 ID |
| data.heroes[].title | string | 英雄名 |
| data.heroes[].playNum | int | 场次 |
| data.heroes[].winRate | string | 胜率,如 55% |
| data.heroes[].heroFightPower | int | 英雄战力 |
| data.heroes[].powerColor | string | 战力配色(与营地档位一致) |
| data.heroes[].heroImg | string | 英雄头像 |
| data.heroes[].honorAbbr | string | 荣耀称号简称,无则空串 |
错误码
| code | HTTP | 说明 |
|---|---|---|
200 |
200 | 成功 |
402 |
402 | 余额不足 |
403 |
403 | 需要 apikey / 无效 Key / 账户禁用 |
429 |
429 | 请求过于频繁或今日次数达上限 |
503 |
503 | 接口维护中 |
502 |
502 | 上游请求失败(可能已自动退费) |
500 |
500 | 服务端错误 |
响应示例
{
"code": 1,
"msg": "ok",
"data": {
"campId": "123456789",
"roleId": "376042248",
"heroes": [
{
"heroId": 131,
"title": "李白",
"playNum": 80,
"winRate": "55%",
"heroFightPower": 8600,
"honorAbbr": ""
}
]
}
}
代码示例