"""丰享商家端 API 客户端。 相比原实现的关键改动: 1. 复用 requests.Session(原代码每 5 秒新建 TLS 连接,纯浪费) 2. 只对「网络层故障」做有限重试,业务错误码不重试 3. 用异常区分三种状态,替代原来返回 "SESSION_EXPIRED" 魔法字符串 """ from __future__ import annotations import logging from typing import Any, Dict, List, Optional import requests from requests.adapters import HTTPAdapter from urllib3.util.retry import Retry from .config import Config log = logging.getLogger("fengxiang.client") # 丰享返回的「会话失效」错误码 SESSION_EXPIRED_CODES = {110003, 10009} class FengxiangError(Exception): """所有客户端异常的基类。""" class SessionExpired(FengxiangError): """Cookie/会话失效,需要重新登录。""" class ApiError(FengxiangError): """接口返回了非 0 的业务错误码。""" def __init__(self, errno: Any, errmsg: str = ""): self.errno = errno self.errmsg = errmsg super().__init__(f"errno={errno} errmsg={errmsg}") class NetworkError(FengxiangError): """网络/超时/非 JSON 响应,可稍后重试。""" class FengxiangClient: def __init__(self, cfg: Config, session: Optional[requests.Session] = None): self.cfg = cfg self.session = session or self._build_session() self.cookies: Dict[str, str] = {} def _build_session(self) -> requests.Session: s = requests.Session() retry = Retry( total=self.cfg.api.max_retries, connect=self.cfg.api.max_retries, read=self.cfg.api.max_retries, backoff_factor=0.5, status_forcelist=(429, 500, 502, 503, 504), allowed_methods=frozenset(["POST"]), raise_on_status=False, ) adapter = HTTPAdapter(max_retries=retry, pool_connections=2, pool_maxsize=4) s.mount("https://", adapter) s.mount("http://", adapter) s.headers.update({ "Content-Type": "application/json", "User-Agent": ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) " "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120 Safari/537.36"), "Referer": self.cfg.api.base_url.rstrip("/") + "/MMS", "Origin": self.cfg.api.base_url.rstrip("/"), }) return s def set_cookies(self, cookies: Dict[str, str]) -> None: self.cookies = dict(cookies or {}) def list_orders(self, page_size: int = 5, page: int = 1) -> List[Dict[str, Any]]: """拉取订单列表。 返回订单列表;会话失效抛 SessionExpired;业务错误抛 ApiError; 网络问题抛 NetworkError。 """ payload = {"shopId": self.cfg.shop_id, "page": page, "pageSize": page_size} try: resp = self.session.post( self.cfg.api.order_url, json=payload, cookies=self.cookies, timeout=self.cfg.api.timeout, ) except requests.RequestException as exc: raise NetworkError(f"请求失败: {exc}") from exc if resp.status_code >= 500: raise NetworkError(f"服务端 {resp.status_code}") if resp.status_code >= 400: raise NetworkError(f"HTTP {resp.status_code}") try: data = resp.json() except ValueError as exc: raise NetworkError(f"响应非 JSON: {resp.text[:120]}") from exc errno = data.get("errno") if errno == 0: orders = (data.get("data") or {}).get("list") or [] return [o for o in orders if isinstance(o, dict)] if errno in SESSION_EXPIRED_CODES: raise SessionExpired(f"errno={errno} {data.get('errmsg', '')}".strip()) raise ApiError(errno, str(data.get("errmsg", ""))) def check_cookie(self, cookies: Dict[str, str]) -> bool: """校验 Cookie 是否可用(不抛异常)。""" self.set_cookies(cookies) try: self.list_orders(page_size=1) return True except SessionExpired: return False except FengxiangError as exc: log.warning("Cookie 校验时出现非会话类错误: %s", exc) return False