Files
jianli-boss/client/server_api.py
T
2026-08-26 11:49:01 +08:00

287 lines
11 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
客户端 → 云端服务端 API 封装
统一管理 token 持久化与请求头
"""
import os
import time
import requests
from loguru import logger
from .config import client_settings
from .fingerprint import generate_client_code
class ServerAPI:
"""调用云端 FastAPI 服务端"""
def __init__(self):
self.base_url = client_settings.SERVER_URL.rstrip("/")
self.token: str | None = None
self.user_id: int | None = None
self.username: str | None = None
self._load_token()
# ------------------------------------------------------------------
# Token 持久化
# ------------------------------------------------------------------
def _token_path(self) -> str:
path = client_settings.TOKEN_FILE
os.makedirs(os.path.dirname(path), exist_ok=True)
return path
def _load_token(self) -> None:
path = self._token_path()
if os.path.exists(path):
try:
with open(path, "r", encoding="utf-8") as f:
lines = f.read().strip().splitlines()
if lines:
self.token = lines[0]
self.user_id = int(lines[1]) if len(lines) > 1 and lines[1] else None
self.username = lines[2] if len(lines) > 2 else None
logger.info("已加载本地 token")
except Exception as e:
logger.warning(f"读取 token 失败:{e}")
def _save_token(self) -> None:
with open(self._token_path(), "w", encoding="utf-8") as f:
f.write(f"{self.token}\n{self.user_id}\n{self.username or ''}")
def _headers(self) -> dict:
return {"Authorization": f"Bearer {self.token}"} if self.token else {}
def _req(self, method: str, url: str, **kwargs) -> requests.Response:
"""云端请求统一入口:网络层异常重试 5 次、每次间隔 1 秒,仍失败才抛出。
仅重试连接类异常(RequestException 发生在请求阶段);
HTTP 状态码错误由调用方 raise_for_status 抛出,不重试。"""
last: Exception | None = None
for i in range(5):
try:
return requests.request(method, url, **kwargs)
except requests.RequestException as e:
last = e
logger.warning(f"云端请求失败({i + 1}/5),1 秒后重试:"
f"{method.upper()} {url}:{e}")
time.sleep(1)
raise last
# ------------------------------------------------------------------
# 认证(账号密码体系)
# ------------------------------------------------------------------
def register(self, username: str, password: str, nickname: str | None = None) -> dict:
"""注册新账号,返回并保存 token"""
resp = self._req("post",
f"{self.base_url}/api/auth/register",
json={"username": username, "password": password, "nickname": nickname},
timeout=15,
)
resp.raise_for_status()
return self._store_auth(resp.json())
def login(self, username: str, password: str) -> dict:
"""账号密码登录,返回并保存 token"""
resp = self._req("post",
f"{self.base_url}/api/auth/login",
json={
"username": username,
"password": password,
"client_code": generate_client_code(), # 仅作设备审计
},
timeout=15,
)
resp.raise_for_status()
return self._store_auth(resp.json())
def _store_auth(self, data: dict) -> dict:
"""保存认证信息到内存与本地文件"""
self.token = data["token"]
self.user_id = data["user_id"]
self.username = data.get("username")
self._save_token()
logger.info(f"认证成功,user_id={self.user_id},username={self.username}")
return data
def logout(self) -> None:
"""清除本地 token"""
self.token = None
self.user_id = None
self.username = None
try:
if os.path.exists(self._token_path()):
os.remove(self._token_path())
except Exception:
pass
def get_me(self) -> dict:
resp = self._req("get", f"{self.base_url}/api/auth/me", headers=self._headers(), timeout=15)
resp.raise_for_status()
return resp.json()
def heartbeat(self) -> bool:
"""发送心跳,刷新服务端 last_seen_at;失败返回 False(不抛异常)"""
if not self.token:
return False
try:
resp = self._req("post",
f"{self.base_url}/api/auth/heartbeat",
headers=self._headers(), timeout=10,
)
return resp.status_code == 200
except Exception as e:
logger.debug(f"心跳发送失败:{e}")
return False
def update_login_status(self, status: str, boss_account: str | None = None) -> dict:
payload = {"login_status": status}
if boss_account:
payload["boss_account"] = boss_account
resp = self._req("put",
f"{self.base_url}/api/auth/login-status",
json=payload, headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
# ------------------------------------------------------------------
# 简历
# ------------------------------------------------------------------
def upload_resumes(self, resumes: list[dict]) -> list[dict]:
"""批量上传简历"""
resp = self._req("post",
f"{self.base_url}/api/resumes/batch",
json={"resumes": resumes}, headers=self._headers(), timeout=30,
)
resp.raise_for_status()
return resp.json()
def list_resumes(self) -> list[dict]:
resp = self._req("get", f"{self.base_url}/api/resumes", headers=self._headers(), timeout=15)
resp.raise_for_status()
return resp.json()
def get_primary_resume(self) -> dict | None:
resp = self._req("get", f"{self.base_url}/api/resumes/primary", headers=self._headers(), timeout=15)
if resp.status_code == 404:
return None
resp.raise_for_status()
return resp.json()
def set_primary_resume(self, resume_id: int) -> dict:
resp = self._req("post",
f"{self.base_url}/api/resumes/{resume_id}/set-primary",
headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
def update_resume(self, resume_id: int, data: dict) -> dict:
"""编辑简历(标题/求职意向/正文)"""
resp = self._req("put",
f"{self.base_url}/api/resumes/{resume_id}",
json=data, headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
def delete_resume(self, resume_id: int) -> dict:
resp = self._req("delete",
f"{self.base_url}/api/resumes/{resume_id}",
headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
# ------------------------------------------------------------------
# 投递会话
# ------------------------------------------------------------------
def start_session(self, keywords: str, city_code: str,
salary_min: int | None, salary_max: int | None) -> dict:
resp = self._req("post",
f"{self.base_url}/api/sessions/start",
json={
"keywords": keywords,
"city_code": city_code,
"salary_min": salary_min,
"salary_max": salary_max,
},
headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
def stop_session(self, session_id: int) -> dict:
resp = self._req("post",
f"{self.base_url}/api/sessions/{session_id}/stop",
headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
def update_session_stats(self, session_id: int, applied_delta: int, skipped_delta: int) -> dict:
resp = self._req("post",
f"{self.base_url}/api/sessions/{session_id}/stats",
json={"applied_delta": applied_delta, "skipped_delta": skipped_delta},
headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
# ------------------------------------------------------------------
# 投递记录
# ------------------------------------------------------------------
def report_application(self, session_id: int | None, data: dict) -> dict:
params = {"session_id": session_id} if session_id else {}
resp = self._req("post",
f"{self.base_url}/api/jobs/report",
json=data, params=params, headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
def check_applied(self, job_id: str) -> bool:
resp = self._req("get",
f"{self.base_url}/api/jobs/check/{job_id}",
headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json().get("applied", False)
def list_blacklist(self) -> list[str]:
"""公司黑名单名单(公司名列表,拉黑后不再投递该公司)"""
resp = self._req("get", f"{self.base_url}/api/blacklist",
headers=self._headers(), timeout=15)
resp.raise_for_status()
return [i["company"] for i in resp.json()]
def get_stats(self) -> dict:
resp = self._req("get", f"{self.base_url}/api/jobs/stats", headers=self._headers(), timeout=15)
resp.raise_for_status()
return resp.json()
def today_applied_count(self) -> int:
"""当天(北京时间)实际投递数量"""
resp = self._req("get", f"{self.base_url}/api/jobs/today-count", headers=self._headers(), timeout=15)
resp.raise_for_status()
return int(resp.json().get("count", 0))
def get_history(self, limit: int = 50, apply_type: str | None = None) -> list[dict]:
params = {"limit": limit}
if apply_type:
params["apply_type"] = apply_type
resp = self._req("get",
f"{self.base_url}/api/jobs/history",
params=params, headers=self._headers(), timeout=15,
)
resp.raise_for_status()
return resp.json()
# ------------------------------------------------------------------
# 连通性
# ------------------------------------------------------------------
def ping(self) -> bool:
try:
resp = requests.get(f"{self.base_url}/", timeout=5)
return resp.status_code == 200
except Exception:
return False