更多接口内容提供

[zxjwzn]

我最近在做有关完美世界查分的bot，对完美的pc客户端进行了逆向。目前收集了一部分http接口，包括需要鉴权的，认证通过js转python实现
以及完美的pc客户端tcp登录，目前也对认证流程还有相关protocol分析的差不多了，等之后用py实现后我可以提供一部分接口内容

[Redamancy520]

欢迎贡献 最近很忙我自己没空搞:(

[zxjwzn]

欢迎贡献 最近很忙我自己没空搞:(

看得出来哈哈哈哈哈

[Redamancy520]

放假了 如果你还愿意提供的话欢迎~ XD

[zxjwzn]

ok

[TRSWNCA]

@zxjwzn 你好，请问有下文吗，我非常关注于 get_match_detail 这个 api，我想这个会帮助做 demo 的管理。

[zxjwzn]

@TRSWNCA 稍等，我给你整理一下

[zxjwzn]

完美对战平台 API 接口说明：get_match_list

1. 接口概述

get_match_list 接口用于获取特定用户的历史比赛战绩。该接口需要进行严格的身份验证，并且会根据传入的查询参数（如时间、分页、游戏模式等）返回加密后的响应数据。

2. 身份验证与请求头

• access_token: 完美平台根据每个用户生成的唯一 Token。此 Token 无论是否重新登录，都永久保持不变。此token可以通过抓包获取。
• pwasteamid: 在 HTTP 请求头（Header）中，必须包含 pwasteamid 字段，其值为与上述 access_token 相绑定的用户 Steam 64位 ID。

3. 请求参数 (Query Parameters)

调用该接口时，需要携带以下参数：

参数名	说明
uid	要查询目标用户的 Steam 64 字节 ID。
page	战绩分页设置，表示当前请求的页数。
page_size	战绩分页设置，表示每页返回的比赛记录数量。
start_time	查询的开始时间，格式为 YYYY-MM-DD HH:MM:SS。API 会严格按此时间筛选。
end_time	查询的截止时间，格式为 YYYY-MM-DD HH:MM:SS。API 会严格按此时间筛选。
season	当前的赛季 ID，例如 “2026S1-共游韶光” 对应的 ID 为 S23。
ticket_id	作用目前尚不明确。
game_types	比赛类型的编号组合，支持多个编号拼接。具体对照表见下文。

比赛类型编号对照表 (game_types)

• 42, 12: 天梯比赛
• 41: 官匹 Pro
• 14: 自定义比赛
• 27: 周末联赛
• 40: 战队匹配
• 16: 第三方比赛
• 10: 杯赛
• 20: 赏金巅峰赛
• 44: 个人巅峰赛
• 10, 16: 双人成行对局
• 51: 快速模式

4. 响应数据格式

调用 API 成功后，接口不会直接返回明文数据，而是返回加密后的 JSON 数据。通常为以下结构：

{
  "code": 0,
  "msg": "",
  "data": {
    "t": 990627,
    "e": "加密内容，非明文"
  }
}

5. 解密程序运作原理解析

返回数据中的 e 是 AES 加密的密文，t 是参与生成解密密钥的动态参数。该解密逻辑由原程序的 JavaScript 代码逆向还原得出。在 Python 中运行此解密代码需要安装 pycryptodome 库（pip install pycryptodome）。

解密逻辑主要分为以下几个步骤：

5.1 生成密钥前缀 (generate_a 函数)

首先，程序会通过特定的逻辑拼接并生成一个固定或半固定的字符串跨度 a，作为 AES 密钥的前缀。

• 生成一个随机数 e 附加到列表中，并利用排序将字符重新打乱。
• 提取并拼接字符，利用 urllib.parse.unquote 对部分固定字符串进行解码（例如解码 Yj6P5%24mny）。
• 将常量字符串（如参数 s 固定为 "MhH8"）附加到末尾，形成完整的前缀。

5.2 构建最终的 AES 密钥

获取前缀 a 后，程序会将接口返回 JSON 中的动态参数 t（转换为字符串）与字符串 a 进行拼接：

key_string = a + t

然后将这个拼接后的字符串编码为 utf-8 字节。为了符合 AES 算法的要求，密钥必须被裁剪或填充至 32 字节长度，从而生成最终的 256 位 AES 密钥。

5.3 AES 解密 (aes_decrypt 函数)

• 密钥: 刚刚经过填充或截断的 32 字节密钥。
• 模式: AES.MODE_ECB (电子密码本模式)。
• 密文: 使用 base64.b64decode 对接口返回的加密字符串 e 进行 Base64 解码后的字节流。

程序使用配置好的 AES 实例对密文进行 decrypt 操作，随后提取出的字节流会使用 UTF-8 进行解码，并去除可能存在的尾随空字符（\0）。最终得到的明文字符串就是一个完整的 JSON 数据（比赛战绩列表）。

---

附：核心解密过程代码示例
(注：敏感数据已隐藏)

# 获取 API 响应中的参数
t = str(data.get("data", {}).get("t", ""))
e = str(data.get("data", {}).get("e", ""))

if t and e:
    # 步骤1：生成前缀
    s = "MhH8"
    a = generate_a(s)
    
    # 步骤2和3：在 aes_decrypt 内部生成密钥并解密
    # 其中调用 aes_decrypt(t, e, a)，第一个参数为 salt(t)，第二个参数为 base64 密文(e)
    decrypted_value = aes_decrypt(e, t, a) 

# ... 此处省略请求等其余代码

# 配置参数示例
class MockWanmeiApiConfig:
    def __init__(self):
        # 用户的 access_token (敏感数据已隐藏)
        self.token = "YOUR_ACCESS_TOKEN_HERE"  
        # 与 token 关联的 SteamID (敏感数据已隐藏)
        self.token_id = "YOUR_STEAM_ID_HERE" 
        self.api_version = 100

---

以下为测试代码

import asyncio
import httpx
import json
import time
import random
import hashlib
import base64
import urllib.parse
import traceback
import ssl
from typing import Dict, Any, Union
import logging
from Crypto.Cipher import AES

# 配置基本的日志记录
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger()

# --- 模拟配置 ---
# 请用您的实际数据替换这些值
class MockWanmeiApiConfig:
    def __init__(self):
        # 您的 access_token
        self.token = "2da4d43f71806xxxxxxxxceabeef939a96e2565c"  
        # 与 token 关联的您的 SteamID
        self.token_id = "76561xxxxxxxx7537" 
        self.api_version = 100

class MockConfig:
    def __init__(self):
        self.wanmei_api = MockWanmeiApiConfig()
        self.verify_ssl = False
        self.api_timeout = 30.0
        self.debug_mode = True

config = MockConfig()

# ------

def generate_a(s: str) -> str:
    """生成AES密钥前缀"""
    e = random.random()
    t = [
        [1 + e, "#r%*"],
        [0 + e, "g"],
        [2 + e, "v"],
        [3 + e, "c"],
        [4 + e, "d"]
    ]
    t.sort(key=lambda x: x[0])
    t = [[x[0], x[1] if len(x[1]) > 1 else x[1].upper()] for x in t]
    a = ''.join(x[1] for x in t)
    a += urllib.parse.unquote("Yj6P5%24mny") + "0838" + s + "d".lower()
    return a

def aes_decrypt(e: str, t: str, a: str) -> Union[Dict[str, Any], str]:
    """AES解密函数"""
    if not e or not t:
        logger.error("AES_ERROR: 无效的解密输入。")
        return ""
    
    key = (a + e).encode('utf-8')
    key = key[:32] if len(key) > 32 else key.ljust(32, b'\0')
    cipher = AES.new(key, AES.MODE_ECB)
    
    try:
        decrypted_data = cipher.decrypt(base64.b64decode(t))
        result = decrypted_data.decode('utf-8').rstrip('\0')
        try:
            return json.loads(result)
        except json.JSONDecodeError:
            return result
    except Exception as ex:
        logger.error(f"解密错误: {ex}")
        return ""

# --- WanmeiApi 逻辑 (使用 httpx) ---

class WanmeiApi:
    @classmethod
    async def get_match_list(cls, steamid: str) -> Dict[str, Any]:
        """获取比赛列表"""
        season = "S23"
        logger.info(f"正在使用硬编码赛季: {season}")
        
        # 按照要求，URL 和 params 在此
        url = "https://pwaweblogin.wmpvp.com/user-info/match-list"
        params = {
            'access_token': config.wanmei_api.token,
            'uid': steamid,
            'page': "1",
            'page_size': "15",
            'game_types': "10,12,14,16,27,20,33,40,41,44",
            'start_time': "2026-03-06 16:00:00",
            'end_time': "2026-06-05 15:59:59",
            'season': season
        }
        
        headers = {
            'User-Agent': "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) perfectworldarena/1.0.24112711 Chrome/80.0.3987.163 Electron/8.5.5 Safari/537.36",
            'pwasteamid': config.wanmei_api.token_id,
            'sec-fetch-site': "none",
            'sec-fetch-mode': "no-cors",
            'accept-language': "zh-CN"
        }
        
        try:
            async with httpx.AsyncClient(
                verify=config.verify_ssl, 
                timeout=config.api_timeout, 
                follow_redirects=True
            ) as client:
                response = await client.get(url, headers=headers, params=params)
                response.raise_for_status()
                data = response.json()

            if "error" in data:
                logger.error(f"API返回错误: {data['error']}")
                return data

            t = str(data.get("data", {}).get("t", ""))
            e = str(data.get("data", {}).get("e", ""))
            
            if t and e:
                s = "MhH8"
                a = generate_a(s)
                decrypted_value = aes_decrypt(t, e, a)
                logger.info("成功解密比赛列表。")
                return {"data": decrypted_value}
            else:
                logger.error("未能从响应数据中提取 't' 或 'e'。完整响应: %s", data)
                return {"error": "未能提取 't' 或 'e'", "response": data}

        except httpx.HTTPStatusError as ex:
            logger.error(f"HTTP 错误: {ex.response.status_code} - {ex.response.text}")
            return {"error": "获取数据失败", "status": ex.response.status_code, "details": ex.response.text}
        except Exception as ex:
            logger.error(f"处理比赛列表时出错: {str(ex)}")
            if config.debug_mode:
                logger.error(f"错误追溯: {traceback.format_exc()}")
            return {"error": str(ex)}

# --- 测试执行 ---

async def main():
    """主函数，用于运行测试。"""
    #要查询的steamid
    test_steamid = "76561199239617537" 
    
    logger.info(f"--- 开始测试 get_match_list, SteamID: {test_steamid} ---")
    
    result = await WanmeiApi.get_match_list(test_steamid)
    
    print("\n--- 测试结果 ---")
    if "error" in result:
        print(f"测试失败。错误: {result.get('error')}")
        if 'details' in result:
            print(f"详情: {result.get('details')}")
    else:
        print("测试成功!")
        print(json.dumps(result, indent=2))

    
if __name__ == "__main__":
    asyncio.run(main()) 

[zxjwzn]

你先看看这个，我再去整理match_detail的

[zxjwzn]

完美对战平台 API 接口说明：获取单局比赛记录详情 (match-api/report)

1. 接口概述

match-api/report 接口用于获取指定 match_id 的单局比赛对局详细数据记录。此接口同样引入了使用动态参数进行签名的验证机制。

请求类型: POST
接口 URL: https://pwaweblogin.wmpvp.com/match-api/report

2. 请求 Header

必须携带类似于完美客户端环境的 User-Agent，例如：
Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) perfectworldarena/1.0.26043012 Chrome/80.0.3987.163 Electron/8.5.5 Safari/537.36

3. 请求负载 (Payload)

在 POST 请求中的 JSON 数据体（即 HTTP Body），用于指定要查询的具体比赛。包含以下字段：

• match_id: 比赛记录的数字 ID 字符串 (如 "9208138822871147788")。
• season: 当前赛季名称 (如 "S23")。
• uid: 对应用户的 Steam64 字节 ID，用于确认查询上下文。

4. URL 参数及签名验证 (Query Params)

为了防止接口被恶意抓取，此接口在请求时需要将签名的相关动态参数拼接在 URL 后（如 ?a=...&r=...&s=...&t=...）。参数由 generate_signature 机制生成产生，如下：

参数	说明
a	客户端的 api 版本号，例如 20000
r	一般为客户端请求时生成的一个随机整数
t	客户端请求时生成的13位毫秒级时间戳
s	数据加密签名结果 (详见下方说明)

4.1 签名机制 (Signature)

生成的签名字串 s，与完美的 search_user 是同一套逻辑，算法如下：

1. 参数提取: 获取上文使用的随机数 r，时间戳 t。
2. 计算负载哈希值 h:
   • 对于 POST 请求，h 为 payload JSON 的紧凑形式序列化字符串（无空格），必须保证 key 是按字典序排序处理的。
3. 计算 MD5:
   针对字符串拼接执行： MD5(r + t + h)
   (拼接顺序：随机数后跟时间戳再跟 h 的字符串转换)
4. 计算 SHA1 (生成最终的签名 s):
   对 MD5 结果以及常数进行 SHA1： SHA1(api版本号 + 前面计算的md5结结果 + 固定 Hex 字节流)

通过这套算法生成签名 s 之后，将所有的动态散列校验和追加回 POST 请求的网址 query 参数中发送给服务器。服务器收到后将解析对应项，以鉴别是否为有效请求。

4.2 历史签名机制 (已失效说明)

郑重提示：以下记录的签名算法逻辑现已失效！ 完美对战平台已经对签名底层算法进行了重构（大概率移交给了后端的 IPC 通信或 Native C++ 层处理，时间戳也改为 10 位），当前已经无法在纯前端 JS 中直接找到哈希拼接过程，且以前对于 POST payload 的验证逻辑也已更改。

以下是遗留逆向代码记录（仅供参考和存档）：

function (e, t, r) {
    const i = r(180),
        s = r(9);
    e.exports = {
        PVP_WEB_API_APPID: 2e4,
        generate_signature: function (e, t, r) {
            let i = s.createHash("md5");
            (i.update(e), i.update(t), i.update(r));
            let a = s.createHash("sha1");
            return (
                a.update((2e4).toString()),
                a.update(i.digest("hex")),
                a.update(Buffer.from("62613037313566323366373266373262396364363938373032393337323765383733643433306234", "hex")),
                a.digest("hex")
            );
        },
        generate_randnum: function (e, t) {
            let r = t - e,
                s = i.random();
            return e + i.floor(s * r);
        },
    };
}

[zxjwzn]

@TRSWNCA 我一时半会还逆向不出来新的签名计算方法说是，但是你可以看看我仓库下的pwhook，那个是通过注入完美客户端实现的，并对外提供了api，可以直接获取到明文，相比于逆向协议也来的更加简单

[TRSWNCA]

非常感谢！看上去确实很复杂，相较以前由很大改动。您的 PWHook 我也 star 了，只是比较担心如果用这套方案，用的人多了会不会被官方注意到并封锁 😿，目前我想要拓展 CS2-insight-agent 做 cn 版本的 cs-demo-manager。
我看到之前的用户相关的 api 不用填写 token 都能使用 CS2-stats，想着这个比赛的 api 是不是也是这种，能比较开放得拿到。看上去不大可行了。

[zxjwzn]

目前官方只做了对常规注入手段的检查，目前使用的方法不会造成任何封禁，即便是在游戏中pac也不会检测

[starrylistener]

完美世界查分

你好，请问完美世界查分这个还有下文吗

[xufezyq]

@zxjwzn @TRSWNCA
前段时间想要做同样的事情，也被卡在签名。最近翻到这个仓库：https://github.com/WangChuDi/CS-Demo-Downloader
也许可以帮助解决

[zxjwzn]

@zxjwzn @TRSWNCA 前段时间想要做同样的事情，也被卡在签名。最近翻到这个仓库：https://github.com/WangChuDi/CS-Demo-Downloader 也许可以帮助解决

简单看了一下，这个是通过调用完美的DLL来获取数据？