317 lines
8.0 KiB
Python
317 lines
8.0 KiB
Python
"""
|
|
码枪堂 原版 (maqt.top) API 接口规格
|
|
来源: app.asar v7.0.4, dist/weapon-tuner.html + dist/assets/CfKCgw5l.js
|
|
"""
|
|
|
|
import hashlib
|
|
import base64
|
|
import json
|
|
from dataclasses import dataclass, field
|
|
from typing import Optional, Any
|
|
|
|
BASE_URL = "https://maqt.top"
|
|
ENCRYPTION_KEY = "maqt-delta-force-2024-secret-key-32"
|
|
AES_KEY = hashlib.sha256(ENCRYPTION_KEY.encode("utf-8")).digest() # 32 bytes
|
|
|
|
CATEGORY_MAP = {
|
|
"AR": "突击步枪",
|
|
"SMG": "冲锋枪",
|
|
"SR": "狙击步枪",
|
|
"LMG": "轻机枪",
|
|
"SG": "霰弹枪",
|
|
"Pistol": "手枪",
|
|
"Launcher": "发射器",
|
|
}
|
|
|
|
# ---- Data Models ----
|
|
|
|
@dataclass
|
|
class WeaponCategory:
|
|
category: str # 实际返回中文名 e.g. "突击步枪"
|
|
scheme_count: int = 0
|
|
|
|
@dataclass
|
|
class Weapon:
|
|
id: int
|
|
weapon_name: str # e.g. "M4A1"
|
|
display_name: str # e.g. "M4A1突击步枪"
|
|
category: str # 中文分类名
|
|
use_count: int = 0
|
|
|
|
@dataclass
|
|
class SchemeItem:
|
|
id: int
|
|
user_id: int
|
|
username: str
|
|
avatar: str
|
|
description: str
|
|
scheme_content: str # 含武器名+模式前缀，如 "M4A1突击步枪-烽火地带-..."
|
|
category: str
|
|
weapon_name: str
|
|
price: Optional[str] # 实际是字符串 e.g. "97W"
|
|
tags: list[str]
|
|
uses: int
|
|
total_historical_uses: int
|
|
status: Optional[str]
|
|
source: Optional[int] # 1:自行 2:别人分享 3:工具生成
|
|
created_at: str
|
|
updated_at: str
|
|
# 合作方字段
|
|
partner_type: Optional[str] # "club" | "none"
|
|
partner_level: Optional[str] # "bronze" | "gold" | "none"
|
|
partner_badge: Optional[str]
|
|
partner_logo: Optional[str]
|
|
social_link: Optional[str]
|
|
|
|
@dataclass
|
|
class Pagination:
|
|
page: int
|
|
limit: int
|
|
hasMore: bool
|
|
|
|
@dataclass
|
|
class SchemeListResponse:
|
|
success: bool
|
|
data: list[SchemeItem]
|
|
pagination: Pagination
|
|
|
|
@dataclass
|
|
class AdvertItem:
|
|
id: str
|
|
author: str
|
|
avatar: str
|
|
shareTime: str
|
|
title: str
|
|
description: str
|
|
image_url: Optional[str]
|
|
link_url: str
|
|
isVip: bool
|
|
|
|
@dataclass
|
|
class UserInfo:
|
|
id: int
|
|
username: str
|
|
avatar: Optional[str] = None
|
|
email: Optional[str] = None
|
|
status: str = "active"
|
|
isVip: int = 0
|
|
vipExpireAt: Optional[str] = None
|
|
freezeUntil: Optional[str] = None
|
|
|
|
@dataclass
|
|
class LoginResponse:
|
|
success: bool
|
|
message: str
|
|
token: Optional[str] = None
|
|
user: Optional[UserInfo] = None
|
|
|
|
@dataclass
|
|
class SessionStatusResponse:
|
|
success: bool
|
|
loggedIn: bool
|
|
user: Optional[UserInfo] = None
|
|
message: Optional[str] = None
|
|
|
|
@dataclass
|
|
class VipStatusData:
|
|
success: bool
|
|
isVip: bool
|
|
vipExpireAt: Optional[str]
|
|
daysRemaining: int
|
|
activatedAt: Optional[str]
|
|
activatedCardKey: Optional[str]
|
|
expired: bool
|
|
message: Optional[str]
|
|
|
|
# ---- Endpoints ----
|
|
|
|
ENDPOINTS = {
|
|
"weapon_categories": {
|
|
"method": "GET",
|
|
"path": "/api/weapon-categories",
|
|
"auth": False,
|
|
"params": None,
|
|
"returns": "list[WeaponCategory]",
|
|
},
|
|
"weapons": {
|
|
"method": "GET",
|
|
"path": "/api/weapons",
|
|
"auth": False,
|
|
"params": {"category": "武器分类代码, optional"},
|
|
"returns": "list[Weapon]",
|
|
},
|
|
"schemes": {
|
|
"method": "GET",
|
|
"path": "/api/schemes",
|
|
"auth": False,
|
|
"params": {
|
|
"sort": "hot | new",
|
|
"page": "页码 (1-based)",
|
|
"limit": "固定 12",
|
|
"weaponCategory": "中文分类名, optional",
|
|
"weaponName": "武器中文名, optional",
|
|
"minPrice": "最低价格, optional",
|
|
"maxPrice": "最高价格, optional",
|
|
"search": "搜索关键词, optional",
|
|
},
|
|
"returns": "SchemeListResponse (可能加密)",
|
|
},
|
|
"schemes_aob": {
|
|
"method": "GET",
|
|
"path": "/api/schemes_aob",
|
|
"auth": False,
|
|
"params": { # 同上
|
|
"sort": "hot | new",
|
|
"page": "页码 (1-based)",
|
|
"limit": "固定 12",
|
|
},
|
|
"returns": "SchemeListResponse (可能加密)",
|
|
},
|
|
"favorites": {
|
|
"method": "GET",
|
|
"path": "/api/favorites",
|
|
"auth": True,
|
|
"params": {"sort": "", "page": "", "limit": "12"},
|
|
"returns": "SchemeListResponse",
|
|
},
|
|
"login": {
|
|
"method": "POST",
|
|
"path": "/api/login",
|
|
"auth": False,
|
|
"body": {
|
|
"username": "string",
|
|
"password": "string",
|
|
"installId": "string, optional",
|
|
"deviceHash": "string, optional",
|
|
"platform": "string, optional",
|
|
"osVersion": "string, optional",
|
|
"appVersion": "string, optional",
|
|
},
|
|
"returns": "LoginResponse",
|
|
},
|
|
"register": {
|
|
"method": "POST",
|
|
"path": "/api/register",
|
|
"auth": False,
|
|
"body": {"username": "", "password": "", "email": ""},
|
|
"returns": "LoginResponse (with token)",
|
|
},
|
|
"session_status": {
|
|
"method": "GET",
|
|
"path": "/api/session-status",
|
|
"auth": True,
|
|
"params": None,
|
|
"returns": "SessionStatusResponse",
|
|
},
|
|
"vip_status": {
|
|
"method": "GET",
|
|
"path": "/api/vip-status",
|
|
"auth": True,
|
|
"params": None,
|
|
"returns": "VipStatusData (可能加密)",
|
|
},
|
|
"activate_vip": {
|
|
"method": "POST",
|
|
"path": "/api/activate-vip",
|
|
"auth": True,
|
|
"body": {"cardKey": "VIP卡密"},
|
|
},
|
|
"favorites_add": {
|
|
"method": "POST",
|
|
"path": "/api/favorites",
|
|
"auth": True,
|
|
"body": {"schemeId": "", "source": "烽火地带"},
|
|
},
|
|
"favorites_remove": {
|
|
"method": "DELETE",
|
|
"path": "/api/favorites/{schemeId}?source={source}",
|
|
"auth": True,
|
|
},
|
|
"favorites_check": {
|
|
"method": "GET",
|
|
"path": "/api/favorites/check?schemeId={id}&source={source}",
|
|
"auth": True,
|
|
},
|
|
"favorites_count": {
|
|
"method": "GET",
|
|
"path": "/api/favorites/count",
|
|
"auth": True,
|
|
},
|
|
"scheme_use": {
|
|
"method": "POST",
|
|
"path": "/api/{mode}/{schemeId}/use",
|
|
"auth": False,
|
|
},
|
|
"scheme_report": {
|
|
"method": "POST",
|
|
"path": "/api/{mode}/{schemeId}/report",
|
|
"auth": True,
|
|
"body": {"reason": "invalid|inappropriate", "description": ""},
|
|
},
|
|
"scheme_share": {
|
|
"method": "POST",
|
|
"path": "/api/schemes", # or /api/schemes_aob
|
|
"auth": False,
|
|
"headers": {"x-user-info": "base64(json({id,username}))"},
|
|
"body": {
|
|
"description": "方案描述 <=50字",
|
|
"category": "武器分类中文名",
|
|
"weaponName": "武器中文名",
|
|
"scheme": "配置代码",
|
|
"tags": [],
|
|
"price": 15, # 烽火模式必填
|
|
},
|
|
},
|
|
"adverts_list": {
|
|
"method": "GET",
|
|
"path": "/api/adverts/list",
|
|
"auth": False,
|
|
},
|
|
"adverts_click": {
|
|
"method": "POST",
|
|
"path": "/api/adverts/{advertId}/click",
|
|
"auth": False,
|
|
},
|
|
"user_stats": {
|
|
"method": "GET",
|
|
"path": "/api/user/stats/{userId}",
|
|
"auth": False,
|
|
},
|
|
"user_schemes": {
|
|
"method": "GET",
|
|
"path": "/api/user/schemes/{userId}",
|
|
"auth": False,
|
|
},
|
|
"user_favorited_count": {
|
|
"method": "GET",
|
|
"path": "/api/user/favorited-count/{userId}",
|
|
"auth": True,
|
|
},
|
|
"filter_share_categories": {
|
|
"method": "GET",
|
|
"path": "/api/filter-share/categories",
|
|
"auth": False,
|
|
},
|
|
"filter_shares": {
|
|
"method": "GET",
|
|
"path": "/api/filter-shares",
|
|
"auth": False,
|
|
},
|
|
"filter_share_copy": {
|
|
"method": "POST",
|
|
"path": "/api/filter-shares/{id}/copy",
|
|
"auth": False,
|
|
"body": {"slot": "primary"},
|
|
},
|
|
"activity_ping": {
|
|
"method": "GET",
|
|
"path": "/api/activity/ping",
|
|
"auth": True,
|
|
},
|
|
"game_map_password": {
|
|
"method": "GET",
|
|
"path": "/api/game/map-password",
|
|
"auth": False,
|
|
},
|
|
}
|