Files
jianli-boss/client/server_api.py
T
2026-08-25 22:53:57 +08:00

247 lines
9.1 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 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 register(self, username: str, password: str, nickname: str | None = None) -> dict:
"""注册新账号,返回并保存 token"""
resp = requests.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 = requests.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 = requests.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 = requests.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 = requests.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 = requests.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 = requests.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 = requests.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 = requests.post(
f"{self.base_url}/api/resumes/{resume_id}/set-primary",
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 = requests.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 = requests.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 = requests.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 = requests.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 = requests.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 get_stats(self) -> dict:
resp = requests.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 = requests.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 = requests.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